org.gcube.data.tm.services
Class TReaderService

java.lang.Object
  org.gcube.data.tm.services.TReaderService

public class TReaderService
extends Object

The implementation of the T-Reader service.

Author:

Lucio Lelii (CNR-ISTI), Fabio Simeoni

Constructor Summary

TReaderService()

Method Summary

String	get(org.gcube.data.tm.stubs.GetParams params) Returns all the Trees in the bound source, after pruning them with a given Pattern.
org.gcube.data.tm.stubs.AnyHolder	getByID(org.gcube.data.tm.stubs.GetByIDParams params) Returns a Tree in the bound source from its identifier, after pruning it with a given pattern.
String	getByIDs(org.gcube.data.tm.stubs.GetByIDsParams params) Returns Trees in the bound source from their identifiers, after pruning them with a given pattern
org.gcube.data.tm.stubs.AnyHolder	getNode(org.gcube.data.tm.stubs.Path path) Returns a Node from the path that connects it to the root of a Tree in the bound source.
String	getNodes(String pathsRs) Returns the Nodes identified by corresponding Paths into trees of the bound source.
TReaderResource	resource() Returns the resource bound to the call

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

TReaderService

public TReaderService()

Method Detail

resource

public TReaderResource resource()
                         throws org.globus.wsrf.ResourceException

Returns the resource bound to the call

Returns:

the resource

Throws:

org.globus.wsrf.ResourceException - if the call specifies no resource or no known resource

getByID

public org.gcube.data.tm.stubs.AnyHolder getByID(org.gcube.data.tm.stubs.GetByIDParams params)
                                          throws org.gcube.data.tm.stubs.UnsupportedOperationFault,
                                                 org.gcube.data.tm.stubs.UnsupportedRequestFault,
                                                 org.gcube.data.tm.stubs.UnknownTreeFault,
                                                 org.gcube.data.tm.stubs.InvalidTreeFault,
                                                 org.gcube.common.core.faults.GCUBEFault

Returns a Tree in the bound source from its identifier, after pruning it with a given pattern.

Parameters:

params - the request parameters

Returns:

an AnyHolder with the DOM representation of the Tree

Throws:

org.gcube.data.tm.stubs.UnsupportedOperationFault - if the data source does not support this operation

org.gcube.data.tm.stubs.UnsupportedRequestFault - if the target plugin does not support this particular request

org.gcube.data.tm.stubs.UnknownTreeFault - if the tree with the given identifier does not exist in the bound source

org.gcube.data.tm.stubs.InvalidTreeFault - if the tree exists in the bound source but does not match the pattern

org.gcube.common.core.faults.GCUBEFault - if the operation fails for an unexpected error

getByIDs

public String getByIDs(org.gcube.data.tm.stubs.GetByIDsParams params)
                throws org.gcube.data.tm.stubs.UnsupportedOperationFault,
                       org.gcube.data.tm.stubs.UnsupportedRequestFault,
                       org.gcube.common.core.faults.GCUBEFault

Returns Trees in the bound source from their identifiers, after pruning them with a given pattern

Parameters:

params - the request parameters

Returns:

a locator to a remote result set of DOM representation of the Trees

Throws:

org.gcube.data.tm.stubs.UnsupportedOperationFault - if the data source does not support this operation

org.gcube.data.tm.stubs.UnsupportedRequestFault - if the target plugin does not support this particular request

org.gcube.common.core.faults.GCUBEFault - if the operation fails for an unexpected error

get

public String get(org.gcube.data.tm.stubs.GetParams params)
           throws org.gcube.data.tm.stubs.UnsupportedOperationFault,
                  org.gcube.data.tm.stubs.UnsupportedRequestFault,
                  org.gcube.common.core.faults.GCUBEFault

Returns all the Trees in the bound source, after pruning them with a given Pattern.

Parameters:

params - the request parameters

Returns:

a locator to a remote Result Set with the pruned trees

Throws:

org.gcube.data.tm.stubs.UnsupportedOperationFault - if the data source does not support this operation

org.gcube.data.tm.stubs.UnsupportedRequestFault - if the target plugin does not support this particular request

org.gcube.common.core.faults.GCUBEFault - if the operation fails for an unexpected error

getNode

public org.gcube.data.tm.stubs.AnyHolder getNode(org.gcube.data.tm.stubs.Path path)
                                          throws org.gcube.data.tm.stubs.UnsupportedOperationFault,
                                                 org.gcube.data.tm.stubs.UnsupportedRequestFault,
                                                 org.gcube.data.tm.stubs.UnknownPathFault,
                                                 org.gcube.common.core.faults.GCUBEFault

Returns a Node from the path that connects it to the root of a Tree in the bound source.

Parameters:

path - the request parameters

Returns:

the node

Throws:

org.gcube.data.tm.stubs.UnsupportedOperationFault - if the data source does not support this operation

org.gcube.data.tm.stubs.UnsupportedRequestFault - if the target plugin does not support this particular request

org.gcube.data.tm.stubs.UnknownPathFault - if the path does not lead to a node

org.gcube.common.core.faults.GCUBEFault - if the operation fails for an unexpected error

getNodes

public String getNodes(String pathsRs)
                throws org.gcube.data.tm.stubs.UnsupportedOperationFault,
                       org.gcube.data.tm.stubs.UnsupportedRequestFault,
                       org.gcube.common.core.faults.GCUBEFault

Returns the Nodes identified by corresponding Paths into trees of the bound source.

Parameters:

pathsRs - a locator to a Result Set with paths

Returns:

a locator a Result Set with nodes

Throws:

org.gcube.data.tm.stubs.UnsupportedOperationFault - if the data source does not support this operation

org.gcube.data.tm.stubs.UnsupportedRequestFault - if the target plugin does not support this particular request

org.gcube.common.core.faults.GCUBEFault - if the operation fails for an unexpected error