Naming (Java Platform SE 6) - xrath.com 에서 번역됨

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM Platform
Standard Ed. 6

앞의 클래스 다음의 클래스

프레임 있어 프레임 없음

개요: 상자 | 필드 | 생성자 | 메소드

상세: 필드 | 생성자 | 메소드

java.rmi
클래스 Naming

java.lang.Object 
  java.rmi.Naming

public final class Naming
extends Object
extends Object

Naming 클래스는, 원격 객체 레지스트리내의 원격 객체에의 참조를 취득 및 포함하기 위한 메소드를 제공합니다. Naming 클래스의 각 메소드는, 그 인수의 1 개로서 다음과 같은 java.lang.String 형의 URL 형식 (다만 스킴 요소는 제외하다)의 이름을 취합니다.

    //host:port/name

host 는 레지스트리가 있는 (원격 또는 로컬) 호스트,port 는 레지스트리가 호출을 받아들이는 포트 번호,name 는 레지스트리에 의해 해석되지 않는 단순한 캐릭터 라인입니다. host 및 port 의 지정은 생략 가능합니다. host 를 생략 하면(자), 디폴트로 로컬 호스트가 사용됩니다. port 를 생략 하면(자), 포트는 디폴트로 1099 가 됩니다. 이것은, RMI 의 레지스트리 rmiregistry 가 사용하는 「잘 알려졌다」포트입니다.

원격 객체의 이름의 「바인딩」이란, 나중에 이 원격 객체를 검색해 사용할 수 있도록(듯이), 원격 객체에 이름을 관련짓는다, 혹은 등록하는 것을 말합니다. Naming 클래스의 bind 메소드 또는 rebind 메소드를 사용해, 원격 객체를 이름과 관련지을 수가 있습니다.

원격 객체가 로컬 호스트로 RMI 레지스트리에 등록 (바인딩)되면(자), 원격 (또는 로컬) 호스트의 호출측은 이름으로 원격 객체를 참조해, 그 참조를 취득해, 그 객체로 원격 메소드를 호출할 수가 있습니다. 레지스트리는 호스트로 동작하고 있는 모든 서버로 공유할 수 있어 필요한 경우는, 개개의 서버 프로세스가 독자적인 레지스트리를 작성 및 사용할 수도 있습니다. 자세한 것은,java.rmi.registry.LocateRegistry.createRegistry 메소드를 참조해 주세요.

도입된 버젼:: JDK1. 1
관련 항목:: Registry , LocateRegistry , LocateRegistry.createRegistry(int)

메소드의 개요
`static void`	`bind (String name, Remote obj)` 지정된 `name` 를 원격 객체에 바인드 합니다.
`static String []`	`list (String name)` 레지스트리내의 바인드 되고 있는 이름의 배열을 돌려줍니다.
`static Remote`	`lookup (String name)` 지정된 `name` 에 관련한 원격 객체의 참조 (Stub)를 돌려줍니다.
`static void`	`rebind (String name, Remote obj)` 지정된 이름을 새로운 원격 객체에 바인드 다시 합니다.
`static void`	`unbind (String name)` 원격 객체에 관련한 지정된 이름에 대한 바인딩을 파기합니다.

클래스 java.lang. Object 로부터 상속된 메소드
`clone , equals , finalize , getClass , hashCode , notify , notifyAll , toString , wait , wait , wait`

메소드의 상세

lookup

public static Remote  lookup(String  name)
                     throws NotBoundException ,
                            MalformedURLException ,
                            RemoteException

지정된 name 에 관련한 원격 객체의 참조 (Stub)를 돌려줍니다.

파라미터:: name - URL 형식의 이름 (다만 스킴 요소는 제외하다)
반환값:: 원격 객체의 참조
예외:: NotBoundException - 이름이 바인드되어 있지 않은 경우; RemoteException - 레지스트리에 접속할 수 없는 경우; AccessException - 이 조작이 허가되어 있지 않은 경우; MalformedURLException - 이름이 적절한 형식의 URL 가 아닌 경우
도입된 버젼:: JDK1. 1

bind

public static void bind(String  name,
                        Remote  obj)
                 throws AlreadyBoundException ,
                        MalformedURLException ,
                        RemoteException

지정된 name 를 원격 객체에 바인드 합니다.

파라미터:: name - URL 형식의 이름 (다만 스킴 요소는 제외하다); obj - 원격 객체의 참조 (일반적으로은 Stub)
예외:: AlreadyBoundException - 이름이 벌써 바인드 되고 있는 경우; MalformedURLException - 이름이 적절한 형식의 URL 가 아닌 경우; RemoteException - 레지스트리에 접속할 수 없는 경우; AccessException - 이 조작이 허가되어 있지 않은 경우 (예를 들어, 로컬이 아닌 호스트로부터 조작하고 있는 경우)
도입된 버젼:: JDK1. 1

unbind

public static void unbind(String  name)
                   throws RemoteException ,
                          NotBoundException ,
                          MalformedURLException

원격 객체에 관련한 지정된 이름에 대한 바인딩을 파기합니다.

파라미터:: name - URL 형식의 이름 (다만 스킴 요소는 제외하다)
예외:: NotBoundException - 이름이 바인드되어 있지 않은 경우; MalformedURLException - 이름이 적절한 형식의 URL 가 아닌 경우; RemoteException - 레지스트리에 접속할 수 없는 경우; AccessException - 이 조작이 허가되어 있지 않은 경우 (예를 들어, 로컬이 아닌 호스트로부터 조작하고 있는 경우)
도입된 버젼:: JDK1. 1

rebind

public static void rebind(String  name,
                          Remote  obj)
                   throws RemoteException ,
                          MalformedURLException

지정된 이름을 새로운 원격 객체에 바인드 다시 합니다. 이름에 대한 기존의 바인딩은 옮겨놓을 수 있습니다.

파라미터:: name - URL 형식의 이름 (다만 스킴 요소는 제외하다); obj - 이름에 관련한 새로운 원격 객체
예외:: MalformedURLException - 이름이 적절한 형식의 URL 가 아닌 경우; RemoteException - 레지스트리에 접속할 수 없는 경우; AccessException - 이 조작이 허가되어 있지 않은 경우 (예를 들어, 로컬이 아닌 호스트로부터 조작하고 있는 경우)
도입된 버젼:: JDK1. 1

list

public static String [] list(String  name)
                     throws RemoteException ,
                            MalformedURLException

레지스트리내의 바인드 되고 있는 이름의 배열을 돌려줍니다. 이름은, URL 형식 (다만 스킴 요소는 제외하다)의 캐릭터 라인입니다. 배열에는, 호출의 시점에서 레지스트리에 존재하는 이름의 snapshot를 포함합니다.

파라미터:: name - URL 형식의 레지스트리명 (다만 스킴 요소는 제외하다)
반환값:: 레지스트리내의 바인드 되고 있다 이름 (적절한 형식)의 배열
예외:: MalformedURLException - 이름이 적절한 형식의 URL 가 아닌 경우; RemoteException - 레지스트리에 접속할 수 없는 경우
도입된 버젼:: JDK1. 1