NIH | National Cancer Institute | NCI Wiki  

Error rendering macro 'rw-search'

null

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

resolveCodingSchemeCopyright

resolveCodingSchemeCopyright

Description:

Return coding scheme copyright given a specific tag or version identifier.

Input:

org.LexGrid.LexBIG.DataModel.cagrid.CodingSchemeIdentification

Output:

org.LexGrid.LexBIG.DataModel.cagrid.CodingSchemeCopyRight

Exception:

RemoteException

Implementation Details:

 

setSecurityToken

setSecurityToken(CodingSchemeIdentification, SecurityToken)

Description:

Sets the Security Token for the given Coding Scheme.

Input:

org.LexGrid.LexBIG.DataModel.cagrid.CodingSchemeIdentification, gov.nih.nci.evs.security.SecurityToken

Output:

org.LexGrid.LexBIG.cagrid.LexEVSGridService.stubs.types.LexEVSGridServiceReference.LexEVSGridServiceReference

Exception:

RemoteException

Implementation Details:

.security.SecurityToken

Output:

org.LexGrid.LexBIG.cagrid.LexEVSGridService.stubs.types.LexEVSGridServiceReference.LexEVSGridServiceReference

Exception:

RemoteException

Implementation Details:

Implementation:
Call this method on the associated LexEVS Service instance (or Distributed LexEVS instance) on the server, and forward the results.

Sample Call:

  1. Connect to the LexEVS caGrid Service using the org.LexGrid.LexBIG.cagrid.adapters.LexBIGServiceAdapter or org.LexGrid.LexBIG.cagrid.adapters.LexBIGServiceGridAdapter
    Code Block
    LexBIGServiceGrid lbs = new LexBIGServiceGridAdapter(url);
  2. Build an org.LexGrid.LexBIG.DataModel.cagrid.CodingSchemeIdentification to hold the Coding Scheme name.
    Code Block
    CodingSchemeIdentification codingScheme = new
    CodingSchemeIdentification(); codingScheme.setName("codingScheme");
  3. Build a gov.nih.nci.evs.security.SecurityToken containing the security information for the desired Coding Scheme.
    Code Block
    SecurityToken metaToken = new SecurityToken();
    metaToken.setAccessToken("token");
  4. Invoke the LexEVS caGrid service as follows: This will return a reference to a new "LexBIGServiceGrid" instance that is associated with the security properties that were passed in.
    Code Block
    LexBIGServiceGrid lbsg = lbs.setSecurityToken(codingScheme, metaToken);

Usage Instructions

Service URL

The LexEVS Grid Service 4.2 URL is: http://lexevsapi.nci.nih.gov/wsrf/services/cagrid/LexEVSGridService.

The service is also accessible via the caGRID Portal.

Required Libraries

The libraries required for programmatic access to the LexEVS Grid Service are listed in the tables below.

The following table lists the 3rd Party Software Libraries required for use of the LexEVS API Grid Service are listed in Table 4.1 and the NCICB software captured under the caBIG® umbrella are listed in Table 4.2.Table 4.1 3rd Party Libraries

Product

Jars

License

Home Page

Apache WS-Addressing

addressing-1.0.jar

adressing 1.0.LICENSE

From Globus 4.0.2 Java Web Services Core lib directory:

http://www.globus.org/toolkit/downloads/4.0.2


Source available at

http://ws.apache.org/addressingImage Modified

...

Apache Axis

axis-ant.jar
axis.jar
commons-pool-1.3.jar
commons-logging-1.1.jar
commons-lang-2.2.jar
commons-collections-3.2.jar
commons-codec-1.3.jar
log4j-1.2.8.jar
jaxrpc.jar
saaj.jar
wsdl4j.jar

...

...

...

Apache Xerces

xercesImpl.jar

xerces.LICENSE

http://xerces.apache.org/xerces-j

Apache Lucene

lucene-core-2.3.2.jar
lucene-regex-2.3.2.jar
lucene-snowball-2.3.2.jar

...

...

...

ASM -
all purpose Java bytecode manipulation and analysis framework

asm.jar

http://asm.objectweb.org/license.html http://asm.objectweb.org/

Castor

castor-1.2.jar

http://www.castor.org/license.html http://www.castor.org/index.html

Globus Toolkit

cog-axis.jar
cog-jglobus.jar

...

...

...

 

Bouncy Castle Crypto APIs

jce-jdk13-125.jar

http://www.bouncycastle.org/licence.html http://www.bouncycastle.org/

Open Permis

wsrf_core.jar
wsrf_core_stubs.jar

...

...

...

The following table lists the required NCICB/caBIG Libraries.

Library

Associated JARs

caGrid Software Libraries

caGrid-ServiceSecurityProvider-client-1.2.jar
caGrid-ServiceSecurityProvider-common-1.2.jar
caGrid-ServiceSecurityProvider-stubs-1.2.jar
caGrid-core-1.2.jar
caGrid-metadata-common-1.2.jar
caGrid-metadata-data-1.2.jar
caGrid-metadata-security-1.2.jar
caGrid-metadatautils-1.2.jar

EVS API Libaries

evsapi42-beans.jar
evsapi42-framework.jar

LexEVS Grid Service Client Library

LexEVSGridService-client.jar

LexEVS Grid Service Stubs

LexEVSGridService-stubs.jar

LexEVS Grid Service Common

LexEVSGridService-common.jar

LexEVS Grid Service Service

LexEVSGridService-service.jar

LexEVS Grid Service Tests

LexEVSGridService-tests.jar

caCORE SDK Library

sdk-client-framework.jar

LexEVS API

lexbig.jar

Custom Castor Serializer

castor-bean-serializer.jar

...

Query for a Concept with a Specific Code

Example: Concept: C12345

Include Page
LexEVS:DataGridQueryByCode Snippet
LexEVS:DataGridQueryByCode Snippet

Query for a Concept with Specific Presentation Text

Example: A concept with a namespace 'SNOMED Clinical Terms' that contains a Presentation equal to 'Heart'

Include Page
LexEVS:DataGridQueryByPresentationText Snippet
LexEVS:DataGridQueryByPresentationText Snippet

Restrict Results to Specific Attributes

Example: Retrieve all of the 'localIds' of any 'SupportedAssociation' in the system.

Include Page
LexEVS:DataGridQueryRestrictByAttributes Snippet
LexEVS:DataGridQueryRestrictByAttributes Snippet

...