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개의 「*」이 말미를 뒤따르는 프로퍼티명의 어느 쪽인지입니다. 말미에 「*」이 붙지 않는 프로퍼티명 패턴은 그 프로퍼티명 자체의 캐릭터 라인과만 일치합니다. 「<이름>*」형식의 프로퍼티명의 패턴은 <이름 > 로 시작되어 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