위치 구문

각 자원에는 특정 PIT(Point In Time)에서 자원을 고유하게 식별하는 위치가 있습니다. 파일 기반 자원은 이 위치를 파일 경로 이름으로 표현합니다. 서버 측 자원의 경우, 해당 위치에는 오브젝트(예: VOB의 데이터베이스 ID)를 찾는 데 필요한 정보가 들어 있습니다.

자원 위치는 서버에서 특성을 읽거나 쓸 때 또는 자원 컨텐츠를 읽거나 쓸 때 필요합니다.

위치 오브젝트는 다음과 같습니다.

StpLocation 오브젝트는 자원 주소를 나타내며 이를 사용하여 자원 프록시를 구성할 수 있습니다(제공자의 자원 프록시 팩토리 메소드 중 하나를 사용). 위치에서 생성된 자원 프록시는 위치로 주소를 표시한 자원과 동일한 유형이어야 하는 것이 일반적인 규칙입니다. 그러나 위치로 주소를 표시한 자원 유형을 항상 주소 스펙 만으로 판별할 수는 없습니다. 따라서 이 규칙은 프록시 생성 시에 항상 적용될 수는 없습니다.

모든 자원에는 클라이언트 세션 사이에 클라이언트의 자원 ID를 저장할 수 있는 고정된 위치 양식이 있습니다. 이 고정 위치는 자원 작성 시 사용된 위치가 아닙니다. 서버는 자원 작성 시에 사용자에 대해 이러한 고정 위치를 작성합니다. 불변하는 자원 특성으로 이 위치를 항상 사용할 수 있습니다. StpLocation 오브젝트는 위치에 대한 문자열 표시를 얻고 해당 문자열을 다시 위치로 구문 분석하는 메소드를 제공합니다.

StpLocation 인스턴스는 컴포넌트 필드로 구문 분석된 위치 스펙을 나타냅니다. 여러 가지 형식이나 스키마를 사용하여 다양한 자원의 위치를 문자열로 표현합니다. 이러한 스키마는 하나 이상의 domain, repository name, namespaceobject name 필드로 구성됩니다. 이름 공간 필드에 따라 사용되는 스키마가 다릅니다.

StpLocation 인터페이스는 위치 스펙을 구성 파트로 구문 분석하는 메소드를 제공합니다. Rational® CM API 클라이언트는 사용 가능한 메소드로 사용자가 제공한 위치 스펙을 검사하여 해당 스펙이 사용 중인 컨텍스트에 적합한지 판별합니다. 이러한 분석을 기초로 클라이언트는 컨텍스트가 누락된 부분을 분명하게 정의한 경우 사용자가 생략한 위치 스펙의 파트를 제공할 수 있습니다.

StpProvider.stpLocation() 메소드를 사용하면 Namespace 매개변수에서 누락된 위치 문자열 스키마를 채우고 클라이언트가 제공자에 대해 식별한 기본 저장소에서 누락된 저장소를 채워 해당 프로세스를 지원합니다. (Javadoc 정보에서 StpProvider.setDefaultRepository 메소드를 참조하십시오.)

사용자 지정 파일 시스템 아티팩트가 필요한 오퍼레이션에는 작업공간 파일 영역으로의 파일 시스템 경로 이름으로 충분합니다. 다른 유형의 사용자 지정 오브젝트가 필요한 오퍼레이션(활동, 프로젝트 또는 레코드 등)에는 다음과 같이 이름별 오브젝트를 식별한 위치 문자열의 정식 지정된 일반 양식을 지정하는 구문을 사용하십시오.
<domain>.<namespace>:<object-name>@<repository-name>
다음 예제에서 기본 도메인은 다음과 같습니다.
"stream:mystream@projects" 
위치 스펙을 이해하는 소프트웨어는 다양한 필드를 생략할 수 있습니다. 예를 들어, 다음과 같습니다.

StpProvider 인터페이스에는 userFriendlySelectorstableSelector 메소드로 USER_FRIENDLY_LOCATION 및 STABLE_LOCATION과 같은 형식의 StpLocation을 빌드하는 메소드가 포함되어 있습니다. StpResource 인터페이스에는 프록시가 정의한 STABLE_LOCATION 및 USER_FRIENDLY_LOCATION의 값을 리턴하는 getStableLocationgetUserFriendlyLocation 메소드가 포함되어 있습니다. 클라이언트가 특정한 형식의 위치를 필요로 하는 경우 StpLocation.stpLocation()을 사용하지 말고 필요한 형식에 해당하는 자원 특성을 요청해야 합니다.


피드백