Understanding com.sas.metadata.remote Interfaces and Classes

Working with the MdOMIUtil Interface

The MdOMIUtil interface provides wrapper methods for methods in the SAS Open Metadata Interface IOMI server interface. MdOMIUtil methods enable you to retrieve existing metadata objects from the SAS Metadata Server.

The MdOMIUtil interface includes AddMetadata, UpdateMetadata, and DoRequest methods. The AddMetadata and UpdateMetadata methods enable you to pass XML-formatted metadata property strings to add and update metadata objects directly on the SAS Metadata Server, instead of having to create Java objects. The DoRequest method enables you to pass XML-formatted method calls. Use of these methods is not recommended. They duplicate functionality provided by Java object interfaces provided by the SAS Java Metadata Interface.

The following table summarizes the basic methods in the MdOMIUtil interface.

Basic MdOMIUtil Methods
Method Name	Description
getRepositories	Gets the ID and name of all repositories registered on the SAS Metadata Server.
getFoundationRepository	Returns the foundation repository for the connected SAS Metadata Server.
getFoundationReposID	Returns the ID of the foundation repository.
getMetadataAllDepths	Gets the properties (attributes and associations) of a specified metadata object.
getMetadataNoCache	Issues a GetMetadata request on the specified object, and then parses the output returned by the SAS Metadata Server so that it is stored in a HashMap. The HashMap contains attribute and association values in key=value pairs.
getMetadataObjectsNoCache	Issues a GetMetadataObjects request on a specified metadata type, and parses the output returned by the SAS Metadata Server so that each returned object's properties are stored in a HashMap.
getMetadataObjectsSubset	Gets a subset of the metadata objects of the requested metadata type.
getObjectPath	Returns the path of an object that resides in the SAS folder tree.
getUserHomeFolder	Gets the user home folder for the specified user.
DoRequest	Passes an XML-formatted IOMI method call to the SAS Metadata Server.

For reference information about each method, see the SAS Java Metadata Interface documentation at support.sas.com/92api.

Using the Get Methods

The get methods enable you to query metadata.

Most of the get methods require you to specify SAS Open Metadata Interface flags and options to identify the information that you want to retrieve. For example, the two getMetadataObjects methods support the OMI_XMLSELECT flag and the <XMLSELECT> element to pass a search string. All four getMetadata* methods support the OMI_TEMPLATE flag and the <TEMPLATES> element to enable you to specify the attributes and associations to retrieve in a property string.

The SAS Java Metadata Interface Get methods support all of the flags and options that are defined for the SAS Open Metadata Interface IOMI GetMetadataObjects and GetMetadata methods. For reference information about the IOMI methods, flags, and options, see Metadata Access (IOMI Interface). For usage information, see Overview of Querying Metadata, Using GetMetadata to Get the Properties of a Specified Metadata Object, Using GetMetadataObjects to Get All Metadata of a Specified Metadata Type, and Filtering a GetMetadataObjects Request.

To make the flags easier to use, the MdOMIUtil interface defines constant values for each of the flags. These constants are in the documentation at support.sas.com/92api. Specify these constant values in your SAS Java Metadata Interface method calls instead of the numeric values that are documented for the IOMI server interface methods.

Top of Page