To create a Data Service Adapter, you must create a Java service that implements one of the adapter interfaces published by the Data Service. The Data Service publishes interfaces for Property Provider Adapters and Data Provider Adapters. The type of Data Service Adapter you must create depends on the information you want to make available through the Data Service.
You create a Property Provider Adapter to allow the Data Service to access new properties for existing vSphere objects, such as virtual machines or hosts. For example, your vSphere environment might contain custom virtual machines or hosts that provide extra properties not normally available through the Data Service. You can create a Property Provider Adapter to extend the Data Service to fetch these additional properties.
You can use a Data Provider Adapter to extend the Data Service to fetch data that is not associated with an existing vSphere object. Typically, you create a Data Provider Adapter for one of the following purposes.
■
|
To retrieve information about a new type of object that you have added to the vSphere environment |
■
|
To retrieve information from a source outside the vSphere environment |
For example, you might create a Data Provider Adapter to handle queries for a new type of vSphere object called Chassis. You might also use a Data Provider Adapter to display data in the vSphere Web Client or the vSphere Client from an external Web source separate from vCenter Server.
To implement one of the adapter interfaces, your Java service must import the com.vmware.vise.data.query package.
After you create the adapter service, you must add the adapter service to the Virgo Server framework and register the adapter with the Data Service. You register an adapter by using the DataServiceExtensionRegistry service, typically within your adapter constructor method. See Registering a Property Provider Adapter and Registering a Data Provider Adapter.
The registration process declares what types of objects and properties the Data Service Adapter can provide. When the Data Service receives a query for one of the registered object or property types, the Data Service routes the query to the proper Data Service Adapter.