Un'applicazione client Rational CM API deve prima ottenere
un proxy per una risorsa prima di poter leggere o aggiornare le proprietà. Prima di poter accedere alle
proprietà da un proxy, il client deve leggere le proprietà dalla risorsa
in un proxy. L'applicazione client deve includere il nome delle proprietà
in una richiesta di proprietà, quando le legge dalla risorsa in un proxy. Ad
esempio:
// Creare una PropertyRequest - specificare i nomi
// delle proprietà desiderate dalla risorsa.
PropertyRequest myPropList1 =
new PropertyRequest(Resource.COMMENT,
Resource.CONTENT_LENGTH,
Resource.CONTENT_TYPE,
Resource.CREATOR_DISPLAY_NAME,
Resource.DISPLAY_NAME);
Per un'interfaccia della risorsa specifica, è possibile specificare le proprietà definite
nella stessa interfaccia o qualsiasi delle interfacce che estende. Ad esempio, per una
query ClearQuest
è possibile specificare le proprietà definite nell'interfaccia CqQuery, nell'interfaccia
CqContextResource, nell'interfaccia CqResource, nell'interfaccia StpResource o
nell'interfaccia Resource:
PropertyRequest myPropListr =
new PropertyRequest(StpResource.USER_FRIENDLY_LOCATION,
Resource.DISPLAY_NAME,
// includere proprietà specifiche a una Query
CqQuery.DISPLAY_FIELDS,
CqQuery.DYNAMIC_FILTERS);
Dopo aver incluso i nomi delle proprietà in una PropertyRequest,
è possibile trasmettere la richiesta al metodo doReadProperties()
del proxy risorsa per leggere le proprietà specificate.