OData 서비스 방문 (WCF Data Services)

본문 은 다음 과 같다. http://msdn.microsoft.com/zh-SG/library/dd728283(v=vs.103
 
WCF 데이터 서 비 스 는 오픈 데이터 프로 토 콜 (OData) 을 지원 하여 URI 를 통 해 주 소 를 찾 을 수 있 는 자원 을 포함 하 는 소스 로 데 이 터 를 공개 합 니 다.              이 자원 들 은 Entity Data Model 의 실체 관계 관례 에 따라 표시 된다.이 모델 에서 실 체 는 응용 프로그램 도 메 인 에서 데이터 형식의 데이터 조작 유닛, 예 를 들 어 고객, 주문, 프로젝트 와 제품 을 나타 낸다.이미지 상태 전송 (REST) 의 의미 (특히 표준 HTTP 술어 GET, PUT, POST, DELETE) 를 사용 하여 실체 데 이 터 를 방문 하고 변경 할 수 있 습 니 다.
자원 주소 지정               
              
            
OData 에서 데이터 모델 에 공 개 된 모든 데 이 터 를 URI 로 찾 을 수 있 습 니 다.               예 를 들 어 아래 URI 는 customers 실체 집합 으로서 의 원본 을 되 돌려 줍 니 다. 이 실 체 는 customer 실체 형식의 모든 인 스 턴 스 항목 을 집중 적 으로 포함 합 니 다.
 
복제 하 다.

http://services.odata.org/Northwind/Northwind.svc/Customers

실 체 는 실체 키 라 는 특수 한 속성 을 가지 고 있다.실체 키 는 실체 집중 에서 유일 하 게 특정한 실 체 를 표시 하 는 데 사용 된다.이렇게 하면 귀 하 는 실체 에서 특정한 실체 유형의 특정한 인 스 턴 스 를 집중 적 으로 찾 을 수 있 습 니 다.예 를 들 어 아래 URI 는 Customer 실체 형식의 키 ALFKI 가 있 는 특정한 인 스 턴 스 항목 을 되 돌려 줍 니 다.
 
복제 하 다.

http://services.odata.org/Northwind/Northwind.svc/Customers('ALFKI')

실체 실례 의 기원 속성 과 복잡 한 속성 에 대해 단독으로 주 소 를 찾 을 수도 있다.예 를 들 어, 다음 URI 는 특정 클 라 이언 트 의 ContactName 속성 값 을 포함 하 는 XML 요 소 를 되 돌려 줍 니 다.
 
복제 하 다.

http://services.odata.org/Northwind/Northwind.svc/Customers('ALFKI')/ContactName

위의 URI 에 $value 종결 점 을 포함 하면 응답 메시지 에서 만 기본 속성의 값 을 되 돌려 줍 니 다.다음 예제 에 서 는 XML 요 소 를 되 돌려 주지 않 고 문자열 "Maria Anders" 만 되 돌려 줍 니 다.
 
복제 하 다.

http://services.odata.org/Northwind/Northwind.svc/Customers('ALFKI')/ContactName/$value

실체 간 의 관 계 는 데이터 모델 에서 관련 으로 정의 된다.이러한 관 계 를 통 해 실체 인 스 턴 스 의 네 비게 이 션 속성 을 사용 하여 관련 실 체 를 주소 지정 할 수 있 습 니 다.다 대 일의 관계 에 대해 네 비게 이 션 속성 은 하나의 관련 실 체 를 되 돌려 줄 수 있다.한 쌍 이 많은 관계 에 대해 네 비게 이 션 속성 은 관련 실 체 를 되 돌려 줄 수 있다.예 를 들 어 아래 URI 는 특정 고객 과 관련 된 모든 주문서 집합의 원본 을 되 돌려 줍 니 다.
 
복제 하 다.

http://services.odata.org/Northwind/Northwind.svc/Customers('ALFKI')/Orders

일반적으로 양 방향 관 계 는 한 쌍 의 네 비게 이 션 속성 에 의 해 표시 된다.이전 예제 에서 보 여 준 관계 에 대한 반전 으로 다음 URI 는 특정 Order 실체 에 속 한 Customer 실체 에 대한 인용 을 되 돌려 줍 니 다.
 
복제 하 다.

http://services.odata.org/Northwind/Northwind.svc/Orders(10643)/Customer

OData 를 통 해 검색 표현 식 결 과 를 바탕 으로 자원 주 소 를 찾 을 수 있 습 니 다.이렇게 하면 계 산 된 표현 식 을 바탕 으로 자원 집합 을 선별 할 수 있다.예 를 들 어 아래 의 URI 는 지 정 된 고객 이 1997 년 9 월 22 일부 터 발송 한 주문 서 를 되 돌려 주기 위해 자원 을 선별 합 니 다.
 
복제 하 다.

http://services.odata.org/Northwind/Northwind.svc/Customers('ALFKI')/Orders?$filter=ShippedDate gt datetime'1997-09-22T00:00:00'

더 많은 정보 에 대해 서 는 OData: URI 약속 (영어 페이지 일 수 있 습 니 다) 를 참조 하 시기 바 랍 니 다.
시스템 조회 옵션               
              
            
OData 는 시스템 조회 옵션 을 정의 합 니 다. 이 옵션 을 사용 하면 자원 에 대한 전통 적 인 조회 작업 을 수행 할 수 있 습 니 다. 예 를 들 어 선별, 정렬, 페이지 나 누 기 등 입 니 다.               예 를 들 어 아래 URI 반환 우편 번호 끝 번 호 는 100 의 모든 Order 실체 집합 과 관련 된 Order 가 아 닙 니 다.세부 실체:
 
복제 하 다.

http://services.odata.org/Northwind/Northwind.svc/Orders?$filter=not endswith(ShipPostalCode,'100')&$expand=Order_Details&$orderby=ShipCity

원본 의 각 항목 을 되 돌려 주 고 주문 한 ShipCity 속성 값 에 따라 정렬 합 니 다.
WCF 데이터 서 비 스 는 다음 OData 시스템 조회 옵션 을 지원 합 니 다.
 
검색 옵션
설명 하 다.
$orderby
되 돌아 오 는 원본 의 실체 에 대한 기본 정렬 순 서 를 정의 합 니 다.아래 의 조 회 는 시 / 현 에 따라 돌아 오 는 고객 원 에 대해 순 위 를 매 긴 다.http://services.odata.org/Northwind/Northwind.svc/Customers?$orderby = Country, City 에 대한 더 많은 정 보 는 OData: OrderBy 시스템 조회 옵션 ($orderby) (영어 페이지 일 수 있 습 니 다) 를 참조 하 십시오.
$top
되 돌아 올 원본 에 포 함 될 실체 수 를 지정 합 니 다.아래 의 예 는 앞의 10 명의 고객 을 뛰 어 넘 고 다음 10 명의 고객 에 게 돌아 갑 니 다.http://services.odata.org/Northwind/Northwind.svc/Customers?$skip = 10 & $top = 10 에 대한 더 많은 정 보 는 OData: Top 시스템 조회 옵션 ($top) (영어 페이지 일 수 있 습 니 다) 를 참조 하 십시오.
$skip
원본 에서 실 체 를 되 돌려 주기 전에 건 너 뛸 실 체 를 지정 합 니 다.아래 의 예 는 앞의 10 명의 고객 을 뛰 어 넘 고 다음 10 명의 고객 에 게 돌아 갑 니 다.http://services.odata.org/Northwind/Northwind.svc/Customers?$skip = 10 & $top = 10 에 대한 더 많은 정 보 는 OData: 시스템 검색 옵션 건 너 뛰 기 ($skip) (영어 페이지 일 수 있 습 니 다) 를 참조 하 십시오.
$filter
원본 에서 되 돌아 오 는 실 체 를 특정 조건 에 따라 선별 하 는 표현 식 을 정의 합 니 다.이 검색 옵션 은 선별 식 을 계산 하 는 논리 적 비교 연산 자, 산술 연산 자, 미리 정 의 된 조회 함 수 를 지원 합 니 다.다음 예제 에서 우편 번호 의 끝 번 호 는 100 이 아 닌 모든 주문 서 를 되 돌려 줍 니 다.http://services.odata.org/Northwind/Northwind.svc/Orders?$filter = not endswith (ShipPostalCode, '100') 에 대한 더 많은 정 보 는 OData: 필터 시스템 검색 옵션 ($filter) (영어 페이지 일 수 있 습 니 다) 를 참조 하 십시오.
$expand
검색 에서 어떤 관련 실 체 를 되 돌려 줄 지 지정 합 니 다.관련 실 체 는 원본 이나 내 연 항목 으로 되 돌아 오 는 실체 와 함께 포 함 됩 니 다.아래 의 예 시 는 고객 의 "ALFKI" 주문서 와 각 주문서 의 항목 에 대한 상세 한 정 보 를 되 돌려 줍 니 다.http://services.odata.org/Northwind/Northwind.svc/Customers('ALFKI')/Orders?$expand=Order_자세 한 정 보 는 OData: 시스템 검색 옵션 확장 ($expand) (영어 페이지 일 수 있 음) 를 참조 하 시기 바 랍 니 다.
$select
투영 에서 돌아 오 는 실체의 속성 을 정의 하기 위해 투영 을 지정 합 니 다.기본적으로 원본 에서 실체의 모든 속성 을 되 돌려 줍 니 다.다음 조 회 는 Customer 실체의 세 가지 속성 만 되 돌려 줍 니 다.http://services.odata.org/Northwind/Northwind.svc/Customers?$select = customerID, CompanyName, City 에 대한 더 많은 정 보 는 OData: 시스템 검색 옵션 선택 ($select) (영어 페이지 일 수 있 음) 를 참조 하 십시오.
$inlinecount
원본 에 원본 에서 돌아 오 는 실체 수 를 포함 하 는 계 수 를 요청 합 니 다.더 많은 정보 에 대해 서 는 OData: Inlinecount 시스템 조회 옵션 ($inlinecount) (영어 페이지 일 수 있 습 니 다) 를 참조 하 시기 바 랍 니 다.
관계 에 주 소 를 찾다.               
              
            
실체 집합 과 실체 인 스 턴 스 를 주 소 를 찾 는 것 외 에 OData 를 통 해 실체 간 관 계 를 나타 내 는 관련 주 소 를 찾 을 수 있 습 니 다.               두 개의 실체 인 스 턴 스 (예 를 들 어 Northwind 예제 데이터베이스 에서 지정 한 주문 과 관련 된 출하 자) 간 의 관 계 를 만 들 거나 변경 하려 면 이 기능 을 사용 해 야 합 니 다.OData 는 $link 연산 자 를 지원 합 니 다. 실체 간 의 관련 주 소 를 찾 는 데 사 용 됩 니 다.예 를 들 어 HTTP PUT 요청 메시지 에 아래 URI 를 지정 하면 지정 한 주문서 의 발송 자 를 새 발송 자로 변경 할 수 있 습 니 다.
 
복제 하 다.

http://services.odata.org/Northwind/Northwind.svc/Orders(10643)/$links/Shipper

더 많은 정보 에 대해 서 는 OData: 각 링크 의 주소 지정 (영어 페이지 일 수 있 습 니 다) 를 참조 하 시기 바 랍 니 다.
되 돌아 오 는 원본 사용 하기               
              
            
OData 자원 을 사용 하 는 URI 는 이 서비스 가 공개 한 실체 데 이 터 를 주소 지정 할 수 있 습 니 다.               웹 브 라 우 저의 주소 필드 에 URI 를 입력 하면 요청 한 자원 을 OData 원본 으로 되 돌려 줍 니 다.더 많은 정보 에 대해 서 는 WCF 데이터 서비스 빠 른 입문 참조 하 시기 바 랍 니 다.웹 브 라 우 저 를 사용 하여 특정한 데이터 서비스 자원 이 예상 한 데 이 터 를 되 돌 릴 수 있 는 지 테스트 할 수 있 지만 생산 데이터 서비스 (이 서비스 들 도 데 이 터 를 만 들 고 업데이트 하 며 삭제 할 수 있 습 니 다) 는 보통 응용 프로그램 코드 나 웹 페이지 의 스 크 립 트 에서 언어 로 접근 합 니 다.더 많은 정보 에 대해 서 는 클 라 이언 트 응용 프로그램 에서 OData 서비스 사용 (WCF Data Services) 참조 하 시기 바 랍 니 다.