javax.management.remote.rmi
클래스 RMIServerImpl

java.lang.Object 
  javax.management.remote.rmi.RMIServerImpl

모든 구현된 인터페이스:

Remote, RMIServer

알려진 직계 서브 클래스:

RMIIIOPServerImpl, RMIJRMPServerImpl

public abstract class RMIServerImpl
extends Object 
implements RMIServer 

커넥터 서버를 나타내는 RMI 객체입니다. 리모트 클라이언트는 newClient(Object) 메서드를 사용해 접속을 작성할 수 있습니다. 이 메서드는 접속을 나타내는 RMI 객체를 리턴합니다.

사용자 코드는 반드시 이 클래스를 직접 참조하지 않습니다. 보통, RMI 접속 서버는 RMIConnectorServer 클래스에서 작성됩니다. 리모트 클라이언트는 보통, JMXConnectorFactory를 사용하는지, RMIConnector를 인스턴스화하는 것에 의해 접속을 작성합니다.

이것은 추상 클래스입니다. 구상 서브 클래스는 JRMP와 IIOP 어느 쪽을 사용할까 등, 클라이언트 접속 객체의 상세를 정의합니다.

도입된 버전 :

1.5

생성자 개요

RMIServerImpl (Map <String, ? > env)
새로운 RMIServerImpl를 구축합니다.

메서드 개요

protected void	clientClosed (RMIConnection client) makeClient 에 의해 작성된 클라이언트 접속의 종료시에 호출되는 메서드입니다.
void	close () 이 접속 서버를 종료합니다.
protected abstract void	closeClient (RMIConnection client) makeClient 로 작성된 클라이언트 접속을 종료합니다.
protected abstract void	closeServer () close() 에 의해 불려가 커넥터 서버를 종료합니다.
protected abstract void	export () 이 RMI 객체를 export 합니다.
ClassLoader	getDefaultClassLoader () 이 커넥터 서버로 사용되는 디폴트의 ClassLoader를 취득합니다.
MBeanServer	getMBeanServer () 이 커넥터 서버의 접속처의 MBeanServer 입니다.
protected abstract String	getProtocol () 이 객체의 프로토콜 캐릭터 라인을 리턴합니다.
String	getVersion () 이 커넥터 서버가 인식하는 RMI 커넥터 프로토콜의 버전 입니다.
protected abstract RMIConnection	makeClient (String connectionId, Subject subject) 새로운 클라이언트 접속을 작성합니다.
RMIConnection	newClient (Object credentials) 새로운 클라이언트 접속을 작성합니다.
void	setDefaultClassLoader (ClassLoader cl) 이 커넥터 서버의 디폴트의 ClassLoader를 설정합니다.
void	setMBeanServer (MBeanServer mbs) 이 커넥터 서버의 접속처의 MBeanServer를 설정합니다.
abstract Remote	toStub () 이 서버 객체의 리모트 처리 가능한 스텁을 리턴합니다.

클래스 java.lang. Object 로부터 상속된 메서드

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

생성자 상세

RMIServerImpl

public RMIServerImpl(Map <String,
? > env)

새로운 RMIServerImpl를 구축합니다.

파라미터:

env - 새로운 RMIServerImpl 속성을 포함한 환경. null인 경우, 비어있는 Map와 동등

메서드의 상세

export

protected abstract void export()
                        throws IOException 

이 RMI 객체를 export 합니다.

예외:

IOException - 이 RMI 객체를 export 할 수 없는 경우

toStub

public abstract Remote  toStub()
                       throws IOException 

이 서버 객체의 리모트 처리 가능한 스텁을 리턴합니다.

반환값:

리모트 처리 가능한 스텁

예외:

IOException - 스텁을 취득할 수 없는 경우. 예를 들어 RMIServerImpl가 아직 export되어 있지 않은 경우 등

setDefaultClassLoader

public void setDefaultClassLoader(ClassLoader  cl)

이 커넥터 서버의 디폴트의 ClassLoader를 설정합니다. 새로운 클라이언트 접속은 이 클래스 로더를 사용합니다. 기존의 클라이언트 접속에 영향은 없습니다.

파라미터:

cl - 이 커넥터 서버로 사용되는 새로운 ClassLoader

관련 항목:

getDefaultClassLoader()

getDefaultClassLoader

public ClassLoader  getDefaultClassLoader()

이 커넥터 서버로 사용되는 디폴트의 ClassLoader를 취득합니다.

반환값:

이 커넥터 서버로 사용되는 디폴트의 ClassLoader

관련 항목:

setDefaultClassLoader(java.lang.ClassLoader)

setMBeanServer

public void setMBeanServer(MBeanServer  mbs)

이 커넥터 서버의 접속처의 MBeanServer를 설정합니다. 새로운 클라이언트 접속은 이 MBeanServer와 서로 작용합니다. 기존의 클라이언트 접속에 영향은 없습니다.

파라미터:

mbs - 새로운 MBeanServer. null 이라도 좋지만, 그 경우, 새로운 클라이언트 접속은 거부되는

관련 항목:

getMBeanServer()

getMBeanServer

public MBeanServer  getMBeanServer()

이 커넥터 서버의 접속처의 MBeanServer 입니다. 이것은 이 객체상에서 setMBeanServer(javax.management.MBeanServer) 에게 건네지는 마지막 값입니다. 메서드 호출이 아직 행해지지 않은 경우는 null이 됩니다.

반환값:

이 커넥터의 접속처의 MBeanServer

관련 항목:

setMBeanServer(javax.management.MBeanServer)

getVersion

public String  getVersion()

인터페이스 RMIServer 기술:

이 커넥터 서버가 인식하는 RMI 커넥터 프로토콜의 버전 입니다. 다음의 형식의 캐릭터 라인이 됩니다.

 protocol-version implementation-name
 

protocol-version는 0 이상의 복수의 정수를 피리어드 (. )(으)로 단락지은 형식이 됩니다. 이 문서에 기재되어 있는 버전의 구현에서는 캐릭터 라인 1.0을 사용합니다.

프로토콜 버전과 구현명의 사이에는 공백 문자를 1개 입력합니다. 구현명의 형식은 지정되지 않습니다 만, 구현의 버전 번호를 포함하는 것을 추천합니다. 보안상의 이유등에의해 구현명으로서 공문자열을 지정할 수도 있습니다.

정의:

인터페이스 RMIServer 내의 getVersion

반환값:

여기서 설명되고 있는 형식의 캐릭터 라인

newClient

public RMIConnection  newClient(Object  credentials)
                        throws IOException 

새로운 클라이언트 접속을 작성합니다. 이 메서드는 makeClient를 호출해, 리턴된 클라이언트 접속 객체를 내부 리스트에 추가합니다. close() 메서드에의해 이 RMIServerImpl가 종료되었을 경우, 리스트내의 각 객체의 close() 메서드가 호출됩니다.

이 내부 리스트내에 클라이언트 접속 객체가 존재하고 있어도, 이 클라이언트 접속 객체가 가비지 컬렉션의 대상으로부터 제외되는 것은 아닙니다.

정의:

인터페이스 RMIServer 내의 newClient

파라미터:

credentials - 이 객체는 RMIConnection을 작성하기 전에 호출측의 인증용으로서 서버에게 건네지는 사용자 정의의 인증서를 지정한다. null도 가능

반환값:

새롭게 작성된 RMIConnection. 보통, makeClient에 의해 작성된 객체. 덧붙여 구현은, RMIConnection을 구현하는 다른 객체에 이 객체를 랩 할 수 있다

예외:

IOException - 새로운 클라이언트 객체를 작성 또는 export 할 수 없는 경우

SecurityException - 지정된 인증서에 서는 서버가 사용자를 인증할 수 없는 경우

IllegalStateException - getMBeanServer() 가 null인 경우

makeClient

protected abstract RMIConnection  makeClient(String  connectionId,
                                            Subject  subject)
                                     throws IOException 

새로운 클라이언트 접속을 작성합니다. 이 메서드는 공개 메서드 newClient(Object) 에 의해 호출합니다.

파라미터:

connectionId - 새로운 접속의 ID. 이 커넥터 서버에 의해 유효화 된 모든 접속은 각각 다른 ID를 가진다. 이 파라미터가 null인 경우의 동작은 부정

subject - 인증 끝난 비인증자. null도 가능

반환값:

새롭게 작성된 RMIConnection

예외:

IOException - 새로운 클라이언트 객체를 작성 또는 export 할 수 없는 경우

closeClient

protected abstract void closeClient(RMIConnection  client)
                             throws IOException 

makeClient 로 작성된 클라이언트 접속을 종료합니다.

파라미터:

client - 이전에 makeClient에 의해 리턴된, closeClient 메서드가 아직 1회 도 불려가 지 않은 접속. client이 null인 경우를 포함해, 어떠한 조건 위반이 있었을 경우, 동작은 부정이 된다

예외:

IOException - 클라이언트 접속을 종료할 수 없는 경우

getProtocol

protected abstract String  getProtocol()

이 객체의 프로토콜 캐릭터 라인을 리턴합니다. 리턴된 캐릭터 라인은 RMI/JRMP인 경우는 rmi, RMI/IIOP인 경우는 iiop가 됩니다.

반환값:

이 객체의 프로토콜 캐릭터 라인

clientClosed

protected void clientClosed(RMIConnection  client)
                     throws IOException 

makeClient 에 의해 작성된 클라이언트 접속의 종료시에 호출되는 메서드입니다. makeClient를 정의하는 서브 클래스는 생성된 객체의 close 메서드가 불려 갔을 때, 이 메서드가 호출되도록 설정할 필요가 있습니다. 이것에 의해 RMIServerImpl 접속 리스트로부터의 삭제가 가능하게 됩니다. 이 리스트내에 client이 존재하고 있지 않아도, 에러가 아닙니다.

이 메서드는 접속 리스트로부터 client를 삭제한 뒤, closeClient(client)를 호출합니다.

파라미터:

client - 종료한 클라이언트 접속

예외:

IOException - closeClient(javax.management.remote.rmi.RMIConnection) 가 이 예외를 Throw 하는 경우

NullPointerException - client이 null인 경우

close

public void close()
           throws IOException 

이 접속 서버를 종료합니다. 이 메서드는 새로운 클라이언트 접속을 더 이상 받아들이지 않게 하기 위한, closeServer() 메서드를 호출합니다. 그러자(면), makeClient 에 의해 리턴된 나머지 RMIConnection 객체 1개 1개에 대해서 그 close 메서드가 호출됩니다.

이 메서드가 2회 이상 불려 갔을 때의 동작은 지정되지 않습니다.

closeServer() 가 IOException을 Throw 했을 경우, 개개의 접속은 종료합니다. 그 후, 이 메서드로부터 IOException가 발생 됩니다.

closeServer() 는 정상적으로 종료했지만, 1개 이상의 접속이 IOException을 Throw 했다고 합니다. 이 경우 모든 접속이 종료한뒤 이러한 IOException 가운데 1개가 발생 됩니다. 1개 이상의 접속이 IOException을 Throw 했을 경우, 이 메서드로부터 발생되는 내용은 부정이 됩니다.

예외:

IOException - closeServer() 또는 RMIConnection.close() 호출이 IOException을 Throw 했을 경우

closeServer

protected abstract void closeServer()
                             throws IOException 

close() 에 의해 불려가 커넥터 서버를 종료합니다. 이 메서드의 종료후, 커넥터 서버는 새로운 접속을 일절 받아들이지 않게 됩니다.

예외:

IOException - 커넥터 서버의 종료에 실패했을 경우