조정된 서비스 필수 항목
조정된 서비스는 IServiceBroker를 통해 획득한 서비스이며 서비스와 해당 클라이언트가 고유한 AppDomain, 프로세스 또는 머신 전반(Live Share의 경우)에 존재할 수 있도록 RPC 호환 인터페이스로 노출됩니다. 조정된 서비스는 주 Visual Studio 프로세스 또는 일부 보조 프로세스에서 제안될 수 있으며 Visual Studio 확장에서 이러한 프로세스 중 하나에서 사용될 수 있습니다.
서비스 사용 및 제공IServiceProvider에 설명된 대로 인터페이스를 통해 더 많은(조정되지 않은) Visual Studio 서비스를 사용할 수 있습니다. 이러한 서비스는 일반적으로 주 Visual Studio 프로세스에서만 사용할 수 있지만 조정된 서비스보다 더 큰 기능 집합을 노출합니다.
Live Share 게스트에서 실행되는 Visual Studio 확장은 Live Share 호스트에서 제공한 대로 이러한 서비스의 하위 집합에 액세스하여 추가 기능을 제공할 수 있습니다. 권한 부여 검사는 Live Share 연결을 통해 적용하여 Live Share 호스트의 보안을 손상시키는 잘못된 Live Share 게스트의 위험을 완화합니다. Live Share를 통해 서비스를 공개하도록 선택한 조정된 서비스의 작성자는 조정된 서비스를 제공하는 방법에 설명된 대로 권한 부여 검사를 구현하는 데 주의해야 합니다.
Service Broker
Visual Studio에는 다른 서비스를 노출하는 GlobalProvider와 유사하고 여기에서 검색할 수 있는 전역 IServiceBroker가 하나 있습니다. 이는 MEF를 통해 검색할 수도 있습니다.
추가 서비스를 제공하는 (또는 일부를 억제하는) 자체 서비스 브로커 중 하나를 사용하여 전역 서비스 브로커를 집계하려는 특정 Visual Studio 기능에서 제공하는 다른 컨텍스트별 서비스 브로커가 있을 수 있습니다.
IServiceBroker는 (의도적으로) 클라이언트가 로컬이나 다른 프로세스 또는 다른 컴퓨터에서 서비스를 가져올 수 있는 블랙박스입니다. 서비스 브로커는 정책이 적용된 하나 이상의 다른 서비스 브로커의 집계일 수 있습니다.
Visual Studio 프로세스의 컨텍스트에 따라 이 전역 서비스 브로커는 변경되는 다른 서비스 브로커 집합의 집계입니다. 프로세스 내의 컨텍스트 변경으로 활성화될 수 있는 조정된 서비스 집합이 변경될 수 있습니다. 예를 들어 솔루션이 로드될 때 활성 솔루션과 관련된 서비스를 사용할 수 있습니다. 다른 지원 구현을 사용하지만 폴더 열기 보기에서도 동일한 서비스를 사용할 수 있습니다. 서비스 구현의 변경은 두 구현이 동일한 계약을 충족해야 하므로 해당 서비스의 클라이언트에 투명하지만 클라이언트는 새 인스턴스를 가져오기 위해 이 컨텍스트 변경(AvailabilityChanged를 알림)을 통해 서비스에 대해 다시 쿼리해야 합니다.
서비스 브로커는 일반적으로 서비스에 대한 프록시를 가져오는 데 사용됩니다. 즉, 클라이언트는 서비스 개체에 대한 참조를 직접 받는 대신 서비스에 대한 모든 메서드 호출과 결과 또는 예외를 클라이언트에 다시 전달하는 스텁을 받습니다. 서비스에서 발생한 이벤트를 클라이언트에 전달할 수도 있습니다. 경우에 따라 서비스는 클라이언트가 메서드를 호출하여 클라이언트에 다시 호출할 수 있는 "대상 개체"를 클라이언트에 제공하도록 요구하거나 지원할 수 있습니다.
조정된 서비스 컨테이너
전역 IServiceBroker에서 서비스를 사용할 수 있도록 서비스를 IBrokeredServiceContainer에 제공해야 합니다. 이 서비스 컨테이너는 서비스 브로커에 서비스 팩터리를 노출할 뿐만 아니라 서비스에 액세스할 수 있는 클라이언트를 제어하고 해당 서비스에 대한 액세스가 변경되면 해당 클라이언트에 알릴 책임이 있습니다.
조정된 서비스의 컴퍼지션
조정된 서비스는 다음 요소로 구성됩니다.
- 서비스의 기능을 선언하고 서비스와 해당 클라이언트 간의 계약 역할을 하는 인터페이스.
- 해당 인터페이스의 구현.
- 서비스에 이름 및 버전을 할당하는 ServiceMoniker.
- 필요한 경우 RPC를 처리하기 위한 동작과 ServiceMoniker를 결합하는 ServiceRpcDescriptor.
- 서비스 팩터리를 제공하기 위한 코드
- 서비스 등록
서비스 인터페이스
이는 표준 .NET 인터페이스일 수 있습니다(C#으로 작성되는 경우가 많음). 조정된 서비스 클라이언트 및 서비스가 고유한 프로세스에 존재하고 RPC를 통해 통신할 수 있으려면 이 인터페이스는 서비스에서 사용할 ServiceRpcDescriptor 제한 사항을 준수해야 합니다. 이러한 제한 사항에는 일반적으로 속성 및 인덱서가 허용되지 않으며 거의 대부분의 메서드가 Task를 반환하거나 다른 비동기 호환 반환 형식을 반환합니다.
조정된 서비스 모니커 및 설명자
서비스를 활성화하려면 모니커를 알고 있어야 합니다. 모니커가 서비스의 설명자에 포함되어 있기 때문에 클라이언트는 일반적으로 ServiceRpcDescriptor를 처리할 수 있습니다. 설명자는 조정된 서비스와 해당 클라이언트 간에 RPC 연결을 설정하는 데 필요한 동작을 추가하거나 Stream의/에 대한 RPC 호출을 직렬화하는 데 필요한 경우를 추가합니다.
Visual Studio는 클라이언트 및 서비스에서 RPC가 통신해야 하는 경우 StreamJsonRpc 라이브러리를 활용하는 조정된 서비스에 ServiceJsonRpcDescriptor 파생 형식을 사용하는 것이 좋습니다. StreamJsonRpc는 여기에 설명된 대로 서비스 인터페이스에 특정 제한을 적용합니다.
설명자를 직접 사용할 필요가 거의 없습니다. 대신 일반적으로 VisualStudioServices 또는 서비스를 제공하는 라이브러리에서 가져온 다음 GetProxyAsync에 대한 인수로 사용됩니다.
ServiceMoniker 클래스뿐 아니라 ServiceJsonRpcDescriptor 클래스는 변경할 수 없으므로 static readonly 필드 또는 속성으로 공유해도 안전합니다.
다른 ServiceRpcDescriptor 파생 형식은 변경할 수 없습니다.
A ServiceMoniker는 직렬화할 수 있습니다. ServiceJsonRpcDescriptor 는 직렬화할 수 없습니다.
서비스 대상 그룹
모든 조정된 서비스는 ServiceAudience 플래그 선택 영역으로 등록됩니다. 이러한 플래그는 클라이언트 및 조정된 서비스가 노출될 연결을 제어합니다.
일반적으로는 Visual Studio 세션 내의 모든 로컬 프로세스에 서비스를 노출하는 ServiceAudience.Local을 선택합니다. 이 설정을 사용하면 Live Share 세션이 활성 상태인 경우에도 서비스는 항상 로컬로 활성화됩니다.
ServiceAudience.LiveShareGuest 플래그가 추가되면 조정된 서비스를 요청하는 Live Share 게스트가 Live Share 호스트와의 원격 연결을 통해 조정된 서비스에 대한 프록시를 가져옵니다.
ServiceAudience에 정의된 플래그의 조합은 합법적입니다. Local 플래그를 설정하지 않고도 LiveShareGuest 플래그를 설정할 수 있습니다. 예: 조정된 서비스를 오직 Live Share 호스트의 Live Share 게스트에만 노출하고 로컬에서는 사용할 수 없습니다(클라이언트와 서비스가 동일한 프로세스에 있는 경우).
RemoteExclusiveClient 플래그 및 RemoteExclusiveServer 플래그는 더 이상 사용되지 않습니다.
클라이언트가 조정된 서비스를 요청할 때 해당 서비스에 대한 ServiceAudience가 무엇인지 또는 서비스가 활성화될 위치가 어디인지를 알 필요가 없습니다. 그러나 서비스에서 이 값을 문서화하고 서비스를 사용하는 개발자가 서비스를 활성화할 수 있는 위치를 인식하여 다양한 컨텍스트에서 해당 서비스에서 가져올 수 있는 데이터의 종류와 서비스를 사용할 수 있는 시기를 예상하는 것이 유용할 수 있습니다.
조정된 클라이언트의 컴퍼지션
클라이언트가 조정된 서비스를 요청하면 서비스를 사용할 수 없을 때 다시 null을 가져오거나 서비스가 활성화에 실패하면 ServiceActivationFailedException이 throw되거나, 서비스에 프록시를 가져옵니다.
프록시는 조정된 서비스가 클라이언트와 동일한 프로세스에서 활성화되는지 아니면 다른 프로세스에서 활성화되는지에 관계없이 사용됩니다.
이 프록시는 클라이언트가 서비스가 있는 위치를 인식할 필요가 없도록 로컬 및 원격 서비스 사례에서 사용 패턴을 조화시키는 데 도움이 됩니다.