org.griphyn.vdl.dbschema
Interface Advanced

All Superinterfaces:

Catalog, VDC

All Known Subinterfaces:

XDC

All Known Implementing Classes:

AnnotationSchema, NXDSchema

public interface Advanced
extends VDC

This common schema interface defines advanced search interfaces for VDC. The advanced methods required permit wildcard searches, partial matches, and candidate list compilations that are not part of the simpler @{link VDC} interface.

Version:

$Revision: 50 $

Author:

Jens-S. V??ckler, Yong Zhao

See Also:

DatabaseSchema, org.griphyn.vdl.dbdriver

Field Summary

Fields inherited from interface org.griphyn.vdl.dbschema.VDC

PROPERTY_PREFIX

Method Summary

List	deleteDefinitionEx(String namespace, String name, String version, int type) Delete one or more definitions from the backend database.
List	getFQDNList(int type) Searches the database for a list of fully-qualified names of the definitions sorted in ascending order.
List	getNamespaceList(int type) Searches the database for a list of namespaces of the definitions Sorted in ascending order.
List	searchDefinitionEx(String namespace, String name, String version, int type) Searches the database for definitions by ns::name:version triple and by type (either Transformation or Derivation).
List	searchLFN(String lfn, int link) Searches the database for all LFNs that match a certain pattern.

Methods inherited from interface org.griphyn.vdl.dbschema.VDC

containsDefinition, deleteDefinition, deleteDefinition, loadDefinition, saveDefinition, searchDefinition, searchFilename

Method Detail

deleteDefinitionEx

List deleteDefinitionEx(String namespace,
                        String name,
                        String version,
                        int type)
                        throws SQLException

Delete one or more definitions from the backend database. The key triple parameters may be wildcards. Wildcards are expressed as null value, or have special characters '%' and '_'.

Parameters:

namespace - namespace

name - name

version - version

type - definition type (TR or DV)

Returns:

a list of definitions that were deleted.

Throws:

SQLException

See Also:

Definition.TRANSFORMATION, Definition.DERIVATION

searchDefinitionEx

List searchDefinitionEx(String namespace,
                        String name,
                        String version,
                        int type)
                        throws SQLException

Searches the database for definitions by ns::name:version triple and by type (either Transformation or Derivation). This version of the search allows for jokers expressed as null value

Parameters:

namespace - namespace, null to match any namespace

name - name, null to match any name

version - version, null to match any version

type - type of definition, see below, or -1 as wildcard

Returns:

a list of Definition items, which may be empty

Throws:

SQLException

See Also:

Definition.TRANSFORMATION, Definition.DERIVATION, VDC.loadDefinition( String, String, String, int )

searchLFN

List searchLFN(String lfn,
               int link)
               throws SQLException

Searches the database for all LFNs that match a certain pattern. The linkage is an additional constraint. This method allows joker characters such as '%' and '_'.

Parameters:

lfn - the LFN name

link - the linkage type of the LFN

Returns:

a list of filenames that match the criterion.

Throws:

SQLException

See Also:

LFN.NONE, LFN.INPUT, LFN.OUTPUT, LFN.INOUT

getNamespaceList

List getNamespaceList(int type)
                      throws SQLException

Searches the database for a list of namespaces of the definitions Sorted in ascending order.

Parameters:

type - type of definition, see below, or -1 for both

Returns:

a list of namespaces

Throws:

SQLException

See Also:

Definition.TRANSFORMATION, Definition.DERIVATION

getFQDNList

List getFQDNList(int type)
                 throws SQLException

Searches the database for a list of fully-qualified names of the definitions sorted in ascending order.

Parameters:

type - type of definition, see below, or -1 for both.

Returns:

a list of FQDNs

Throws:

SQLException

See Also:

Definition.TRANSFORMATION, Definition.DERIVATION