12.2. 서비스 내보내기

예를 들어 예 12.1. “단일 인터페이스를 사용한 샘플 서비스 내보내기” 에 표시된 블루프린트 구성 코드를 사용하여 org.fusesource.example.Account 인터페이스 이름 아래에 SavingsAccountImpl 클래스의 인스턴스를 내보낼 수 있습니다.

<blueprint xmlns="http://www.osgi.org/xmlns/blueprint/v1.0.0">

  <bean id="savings" class="org.fusesource.example.SavingsAccountImpl"/>

  <service ref="savings" interface="org.fusesource.example.Account"/>

</blueprint>

여기서 ref 속성은 해당 빈 인스턴스의 ID를 지정하고 interface 속성은 서비스가 OSGi 서비스 레지스트리에 등록된 공용 Java 인터페이스의 이름을 지정합니다. 이 예제에서 사용되는 클래스 및 인터페이스는 다음과 같습니다. 예 12.2. “샘플 계정 클래스 및 인터페이스”

package org.fusesource.example

public interface Account { ... }

public interface SavingsAccount { ... }

public interface CheckingAccount { ... }

public class SavingsAccountImpl implements SavingsAccount
{
    ...
}

public class CheckingAccountImpl implements CheckingAccount
{
    ...
}

예를 들어 다음 블루프린트 구성 코드를 사용하여 공용 Java 인터페이스 목록 org.fusesource.example. Account 및 org.fusesource.example.SavingsAccount 목록 아래에 SavingsAccountImpl 클래스의 인스턴스를 내보낼 수 있습니다.

<blueprint xmlns="http://www.osgi.org/xmlns/blueprint/v1.0.0">
  <bean id="savings" class="org.fusesource.example.SavingsAccountImpl"/>
  <service ref="savings">
    <interfaces>
      <value>org.fusesource.example.Account</value>
      <value>org.fusesource.example.SavingsAccount</value>
    </interfaces>
  </service>
  ...
</blueprint>

예를 들어 구현된 모든 공용 인터페이스 아래에 SavingsAccountImpl 클래스의 인스턴스를 내보내려면 다음 블루프린트 구성 코드를 사용합니다.

<blueprint xmlns="http://www.osgi.org/xmlns/blueprint/v1.0.0">
  <bean id="savings" class="org.fusesource.example.SavingsAccountImpl"/>
  <service ref="savings" auto-export="interfaces"/>
  ...
</blueprint>

여기서 auto-export 속성의 interface 값은 블루프린트가 SavingsAccountImpl 에서 구현한 모든 공용 인터페이스를 등록해야 함을 나타냅니다. auto-export 속성에 다음과 같은 유효한 값이 있을 수 있습니다.

예를 들어 bank.name 문자열 속성을 비용 절감 계정 서비스와 연결하려면 다음 블루프린트 구성을 사용할 수 있습니다.

<blueprint xmlns="http://www.osgi.org/xmlns/blueprint/v1.0.0"
           xmlns:beans="http://www.springframework.org/schema/beans"
           ...>
  ...
  <service ref="savings" auto-export="interfaces">
    <service-properties>
      <beans:entry key="bank.name" value="HighStreetBank"/>
    </service-properties>
  </service>
  ...
</blueprint>

여기서 bank.name 문자열 속성에는 HighStreetBank 값이 있습니다. 문자열 이외의 유형의 서비스 속성을 정의할 수 있습니다. 즉, 기본 유형, 배열 및 컬렉션도 지원됩니다. 이러한 유형을 정의하는 방법에 대한 자세한 내용은 Spring Reference Guide 에서 Advertised 속성 설정 제어를 참조하십시오.

<service ref="savings" interface="org.fusesource.example.Account" ranking="10"/>

예를 들어 다음 블루프린트 구성은 registration-listener 요소에서 참조하는 리스너 8080 listenerBean 을 정의하여 계정 서비스가 등록되거나 등록되지 않을 때마다 리스너 28이 콜백을 수신하도록 합니다.

<blueprint xmlns="http://www.osgi.org/xmlns/blueprint/v1.0.0" ...>
  ...
  <bean id="listenerBean" class="org.fusesource.example.Listener"/>

  <service ref="savings" auto-export="interfaces">
    <registration-listener
        ref="listenerBean"
        registration-method="register"
        unregistration-method="unregister"/>
  </service>
  ...
</blueprint>

registration-listener 요소의 ref 속성이 리스너 8080의 ID를 참조하는 경우 registration-method 속성은 등록 콜백을 수신하는 리스너 메서드의 이름을 지정하고, unregistration-method 속성은 등록 콜백을 수신하는 리스너 메서드의 이름을 지정합니다.

다음 Java 코드는 등록 및 등록 취소 이벤트 알림을 수신하는 Listener 클래스의 샘플 정의를 보여줍니다.

package org.fusesource.example;

public class Listener
{
    public void register(Account service, java.util.Map serviceProperties) {
        ...
    }

    public void unregister(Account service, java.util.Map serviceProperties) {
        ...
    }
}

메서드 이름, 등록 및 등록 취소 는 각각 registration-method 및 unregistration-method 속성으로 지정됩니다. 이러한 메서드의 서명은 다음 구문을 준수해야 합니다.