org.omg.CORBA
클래스 Context

java.lang.Object 
  org.omg.CORBA.Context

public abstract class Context
extends Object 

Request 오퍼레이션으로, 이 호출과 함께 송출되기 전에 문맥 캐릭터 라인을 해결할 필요가 있는 문맥 객체의 지정으로 사용되는 객체입니다. 해결된 문맥 캐릭터 라인은, 요구의 호출과 함께 보내집니다. Context 객체는,NamedValue 객체의 형식에서 프로퍼티의 리스트를 포함합니다. 그러한 프로퍼티은, 클라이언트, 환경, 또는 요구의 상황에 대한 정보를 나타내서 , 일반적으로, 파라미터로서 건네주는 것이 어려운 프로퍼티입니다.

Context 객체는, 우선 ORB 메소드의 get_default_context 를 호출해, 다음에 디폴트의 문맥으로 create_child 메소드를 호출하는 것에 의해 작성됩니다.

Context 객체의 각 프로퍼티은,NamedValue 객체에 의해 나타내집니다. 프로퍼티명은 NamedValue 객체의 name 필드에 포함되어 그 이름에 관련한 값은 NamedValue 객체의 value 필드에 할당할 수 있었던 Any 객체에 포함됩니다.

Context 의 프로퍼티은, 서버의 환경에 보내지는 ( 및 암묵적으로 그 일부가 된다) 클라이언트 또는 어플리케이션의 환경의 일부를 나타낼 수가 있습니다 (윈도우 식별자나 사용자 설정 정보 등). 서버가 불려 가면(자) (즉 프로퍼티이 보내진 뒤), 서버는 get_values 메소드를 사용해, 그 Context 객체에 그 프로퍼티에 대해 문의할 수가 있습니다.

오퍼레이션의 선언에 context 절이 정의되고 있는 경우, Stub 및 스켈리턴은 그 문맥용으로서 부가적인 인수를 가집니다. 오퍼레이션의 호출이 발생하면(자), ORB 는 IDL 의 오퍼레이션 정의로 이름이 붙여져, 클라이언트의 Context 객체에 있는 프로퍼티이, 불려 간 메소드에의 Context 객체 파라미터로 제공되도록(듯이) 합니다.

Context 프로퍼티명 (캐릭터 라인)은, 일반적으로, OMG IDL 식별자 또는 피리어드로 단락지어진 일련의 OMG IDL 식별자의 형식이 됩니다. 문맥 프로퍼티명의 패턴은, 프로퍼티명, 또는 1 개(살)의 「*」이 말미를 뒤따르는 프로퍼티명의 어느 쪽인지입니다. 말미에 「*」이 붙지 않는 프로퍼티명 패턴은, 그 프로퍼티명 자체의 캐릭터 라인과만 일치합니다. <이름>*」형식의 프로퍼티명의 패턴은, <이름 > 로 시작되어 0 이상의 문자가 계속되는 어느 프로퍼티명과도 일치합니다.

프로퍼티명의 패턴은, 오퍼레이션 정의의 context 절로, 또는 Context.get_values 메소드의 파라미터로서 사용됩니다.

Context 객체는, 특정의 디폴트의 동작을 실시하기 위해서(때문에) 서로 연쇄시킬 수가 있습니다. create_child 메소드로 작성된 Context 객체는, 그 부모 (그것을 작성한 Context 객체)에게 연쇄됩니다. 즉 그 부모는, 프로퍼티명의 검색으로 아이의 뒤에 검색됩니다.

어느 Context 객체로 정의된 프로퍼티은, 그 1 개(살)상의 레벨로 정의된 그 프로퍼티을 오버라이드(override) 합니다. 프로퍼티의 검색으로 사용되는 범위는,get_values 메소드를 호출할 때 개시 범위를 지정해,CTX_RESTRICT_SCOPE 플래그를 사용하는 것으로써 제한할 수 있습니다.

Context 객체는, 개시 검색 범위를 지정하는 목적으로 이름 붙일 수가 있습니다.

도입된 버젼:

JDK1. 2

생성자 의 개요

Context ()

메소드의 개요

abstract String	context_name () 이 Context 객체의 이름을 가져옵니다.
abstract Context	create_child (String child_ctx_name) 캐릭터 라인으로 이름을 지정해, 이 Context 객체를 부모로 하는 Context 객체를 생성합니다.
abstract void	delete_values (String propname) name 필드가, 지정된 프로퍼티명으로 일치하는 NamedValue 객체를, 이 Context 객체로부터 삭제합니다.
abstract NVList	get_values (String start_scope, int op_flags, String pattern) name 필드가, 지정된 이름, 또는 지정된 이름 패턴과 일치하는 NamedValue 객체를 가져옵니다.
abstract Context	parent () 이 Context 객체의 부모를 가져옵니다.
abstract void	set_one_value (String propname, Any propvalue) NamedValue 객체를 생성해, 그 객체를 이 Context 객체에 추가합니다.
abstract void	set_values (NVList values) 이 Context 객체의 1 개 이상의 프로퍼티치를 설정합니다.

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

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

생성자 의 상세

Context

public Context()

메소드의 상세

context_name

public abstract String  context_name()

이 Context 객체의 이름을 가져옵니다.

반환값:

이 Context 객체의 이름

parent

public abstract Context  parent()

이 Context 객체의 부모를 가져옵니다.

반환값:

이 Context 객체의 부모인 Context 객체

create_child

public abstract Context  create_child(String  child_ctx_name)

캐릭터 라인으로 이름을 지정해, 이 Context 객체를 부모로 하는 Context 객체를 생성합니다.

새로운 Context 객체는, 그 부모인 Context 객체에 연쇄됩니다. 즉, 일치하는 프로퍼티명의 검색으로, 일치하는 프로퍼티명이 이 문맥으로 발견되지 않는 경우, 그 부모로 검색이 계속됩니다. 부모라도 일치하는 프로퍼티명이 발견되지 않는 경우는, 한층 더 그 부모 (존재하는 경우)로, 검색은 차례차례로 계속됩니다.

파라미터:

child_ctx_name - 새로운 Context 객체의 이름으로서 설정되는 String 객체

반환값:

지정된 이름으로 초기화된, 새롭게 작성된 아이인 Context 객체

set_one_value

public abstract void set_one_value(String  propname,
                                   Any  propvalue)

NamedValue 객체를 생성해, 그 객체를 이 Context 객체에 추가합니다. 새로운 NamedValue 객체의 name 필드는, 지정된 캐릭터 라인으로 설정되어value 필드는, 지정된 Any 객체로 설정되어flags 필드는 0 으로 설정됩니다.

파라미터:

propname - 설정되는 프로퍼티의 이름

propvalue - 프로퍼티의 값이 설정된다 Any 객체. 이 Any 객체의 value 필드는, 지정된 propname 와 관련하는 값을 포함한다. kind 필드는 TCKind.tk_string 로 설정되지 않으면 안 된다

set_values

public abstract void set_values(NVList  values)

이 Context 객체의 1 개 이상의 프로퍼티치를 설정합니다. 이 메소드로 지정된 NVList 는, 1 개(살) 이상의 NamedValue 객체를 포함합니다. 각 NamedValue 객체에서는,name 필드는 프로퍼티명을 가져,flags 필드는 0 으로 설정됩니다. NamedValue 객체의 value 필드는 Any 객체를 포함해, 그 Any 객체는 프로퍼티의 값을 포함합니다. 값은 항상 캐릭터 라인이기 (위해)때문에,Any 객체에서는, 그 TypeCode 의 kind 필드를 TCKind.tk_string 로 설정할 필요가 있습니다.

파라미터:

values - 프로퍼티명, 및 거기에 관련한다 설정치를 포함하는 NVList

관련 항목:

get_values(java.lang.String, int, java.lang.String) , NamedValue , Any

delete_values

public abstract void delete_values(String  propname)

name 필드가, 지정된 프로퍼티명으로 일치하는 NamedValue 객체를, 이 Context 객체로부터 삭제합니다. propname 로 지정된 String 객체의 말미에 와일드 카드 문자 (*)가 있는 경우,name 필드가 일치하는 모든 NamedValue 객체가 삭제됩니다. 검색 범위는, 항상 이 Context 객체에 제한됩니다.

일치하는 프로퍼티이 발견되지 않는 경우는, 예외가 돌려주어집니다.

파라미터:

propname - 삭제되는 프로퍼티의 이름

get_values

public abstract NVList  get_values(String  start_scope,
                                  int op_flags,
                                  String  pattern)

name 필드가, 지정된 이름, 또는 지정된 이름 패턴과 일치하는 NamedValue 객체를 가져옵니다. 이 메소드에서는, 와일드 카드 검색 을 할 수가 있습니다. 즉, 일치하는 프로퍼티이 다수 있는 경우는, 복수의 값이 돌려주어집니다. 프로퍼티이 지정된 레벨로 발견되지 않는 경우, 일치하는 프로퍼티이 발견될 때까지, 혹은 연쇄내의 모든 Context 객체가 검색될 때까지, 문맥 객체 트리의 윗방향에 검색이 계속됩니다.

일치하는 프로퍼티이 발견되지 않는 경우는, 에러가 돌려주어져 프로퍼티 리스트는 돌려주어지지 않습니다.

파라미터:

start_scope - 지정된 프로퍼티의 검색을 개시한다 문맥 객체 레벨을 나타낸다 String 객체 (_USER, _GROUP, _SYSTEM 등). 유효한 범위명은 구현에 고유. 범위명이 생략 되면(자), 검색은 지정된 문맥 객체로 개시된다. 지정된 범위명이 발견되지 않는 경우는 예외가 반환되는

op_flags - 오퍼레이션 플래그. 지정할 수 있다 유일한 플래그는 CTX_RESTRICT_SCOPE. 이 플래그가 지정되면(자), 검색은 지정된 start_scope, 즉, 이 Context 객체에 제한되는

pattern - 치가 취득된다 프로퍼티명. pattern 는 이름, 또는 말미에 와일드 카드 문자 (*)를 가지는 이름

반환값:

대응하는 프로퍼티명이, 지정된 이름, 또는 지정된 이름 패턴과 일치한다 모든 프로퍼티치 (NamedValue 객체의 형식)를 포함하고 있는 NVList

관련 항목:

set_values(org.omg.CORBA.NVList) , NamedValue