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

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

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

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

어느 Context 오브젝트로 정의된 프로퍼티는 그 1 kr상의 레벨로 정의된 그 프로퍼티를 오버라이드(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 kr 이상의 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