|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface ICatalogService
The service responsible for providing a access to information about available Team Foundation Server resources.
Method Summary | |
---|---|
CatalogChangeContext |
createChangeContext()
Creates a change context in which many changes can be batched |
ILocationService |
getLocationService()
|
CatalogNode[] |
getRootNodes()
|
CatalogNode[] |
queryNodes(java.lang.String[] pathSpecs,
com.microsoft.tfs.util.GUID[] resourceTypeFilters,
CatalogQueryOptions queryOptions)
Returns the catalog nodes that exist below the parentPath and have a type that is listed in resourceTypeFilters. |
CatalogNode[] |
queryNodes(java.lang.String[] pathSpecs,
com.microsoft.tfs.util.GUID[] resourceTypeFilters,
CatalogResourceProperty[] propertyFilters,
CatalogQueryOptions queryOptions)
Returns the catalog nodes that exist below the parentPath and have a type that is listed in resourceTypeFilters. |
CatalogNode[] |
queryParents(com.microsoft.tfs.util.GUID resourceIdentifier,
java.lang.String[] pathFilters,
com.microsoft.tfs.util.GUID[] resourceTypeFilters,
boolean recurseToRoot,
CatalogQueryOptions queryOptions)
Returns the nodes for the resource provided as well as the parents. |
CatalogResource[] |
queryResources(com.microsoft.tfs.util.GUID[] resourceIdentifiers,
CatalogQueryOptions queryOptions)
Returns the resource that is associated with the identifier. |
CatalogResource[] |
queryResources(com.microsoft.tfs.util.GUID[] resourceTypeIdentifiers,
CatalogResourceProperty[] propertyFilters,
CatalogQueryOptions queryOptions)
Returns all of the catalog resources of the provided type. |
CatalogResource[] |
queryResourcesByType(com.microsoft.tfs.util.GUID[] resourceTypeIdentifiers,
CatalogQueryOptions queryOptions)
Returns all of the catalog resources of the provided type. |
CatalogResourceType[] |
queryResourceTypes(com.microsoft.tfs.util.GUID[] resourceTypeIdentifiers)
Returns the resource types for all of the specified identifiers. |
CatalogNode |
queryRootNode(CatalogTree tree)
Returns the specified root node. |
CatalogNode[] |
queryUpTree(java.lang.String path,
com.microsoft.tfs.util.GUID[] resourceTypeFilters,
CatalogQueryOptions queryOptions)
Queries "up" the tree from the provided path looking for the provided types in its parent nodes' children. |
void |
saveDelete(CatalogNode node,
java.lang.Boolean recurse)
Deletes this node from the catalog. |
void |
saveMove(CatalogNode nodeToMove,
CatalogNode newParent)
Adds this move to the change context. |
void |
saveNode(CatalogNode node)
Saves the updated node and its resource in the catalog. |
void |
saveResource(CatalogResource resource)
Saves the updated resource in the catalog. |
Method Detail |
---|
CatalogResourceType[] queryResourceTypes(com.microsoft.tfs.util.GUID[] resourceTypeIdentifiers)
resourceTypeIdentifiers
- Identifiers for the resource types that should be returned. If
this has a value of null or empty, all resource types will be
returned.
CatalogResource[] queryResources(com.microsoft.tfs.util.GUID[] resourceIdentifiers, CatalogQueryOptions queryOptions)
resourceIdentifiers
- The identifiers for the resources that are being search for.queryOptions
- If ExpandDependencies is specified, the Dependencies property on
nodes will contain the nodes they are dependent on. If
IncludeParents is specified, the ParentNode property on the
CatalogNode will contain the parent node. Leaving a given option
will result in the returned catalog nodes to have null for that
value. Extra data should only be retrieved if it is needed since
computing and sending information can be expensive.
CatalogResource[] queryResourcesByType(com.microsoft.tfs.util.GUID[] resourceTypeIdentifiers, CatalogQueryOptions queryOptions)
GUID.EMPTY
is passed in, all resources are returned.
resourceTypeIdentifiers
- The identifier for the type of resource to filter on.queryOptions
- If ExpandDependencies is specified, the Dependencies property on
nodes will contain the nodes they are dependent on. If
IncludeParents is specified, the ParentNode property on the
CatalogNode will contain the parent node. Leaving a given option
will result in the returned catalog nodes to have null for that
value. Extra data should only be retrieved if it is needed since
computing and sending information can be expensive.
CatalogResource[] queryResources(com.microsoft.tfs.util.GUID[] resourceTypeIdentifiers, CatalogResourceProperty[] propertyFilters, CatalogQueryOptions queryOptions)
GUID.EMPTY
is passed in, all resources are returned.
resourceTypeIdentifiers
- The identifier for the type of resource to filter on.propertyFilters
- The set of property filters to apply to the resource found.
Matches will be based on both the key and the value of the
property matching. If the value of a certain filter is null or
empty then it will be assumed that all resource with the supplied
property should be returned. A match consists of a resource that
matches all of the propertyFilters.queryOptions
- If ExpandDependencies is specified, the Dependencies property on
nodes will contain the nodes they are dependent on. If
IncludeParents is specified, the ParentNode property on the
CatalogNode will contain the parent node. Leaving a given option
will result in the returned catalog nodes to have null for that
value. Extra data should only be retrieved if it is needed since
computing and sending information can be expensive.
CatalogNode[] queryUpTree(java.lang.String path, com.microsoft.tfs.util.GUID[] resourceTypeFilters, CatalogQueryOptions queryOptions)
path
- The path of the item from where the "up" query should originate.
Wildcards cannot be used in this path.resourceTypeFilters
- The list of types that this query should include. If this is null
or empty, all types will be included.queryOptions
- If ExpandDependencies is specified, the Dependencies property on
nodes will contain the nodes they are dependent on. If
IncludeParents is specified, the ParentNode property on the
CatalogNode will contain the parent node. Leaving a given option
will result in the returned catalog nodes to have null for that
value. Extra data should only be retrieved if it is needed since
computing and sending information can be expensive.
CatalogNode[] queryParents(com.microsoft.tfs.util.GUID resourceIdentifier, java.lang.String[] pathFilters, com.microsoft.tfs.util.GUID[] resourceTypeFilters, boolean recurseToRoot, CatalogQueryOptions queryOptions)
resourceIdentifier
- The identifier for the resource who's parents are being queried.
The resource and its nodes will only be returned if they are not
filtered out.pathFilters
- Nodes will only be returned if they live under one of the paths
provided here. If this value is null or empty it will be assumed
that parents from all places within the tree are valid.resourceTypeFilters
- The list of types that this query should include. If this is null
or empty, all types will be included.recurseToRoot
- If this is true then parent nodes will be enumerated all the way
to the root. If this is false then only the first level of parents
will be returned.queryOptions
- If ExpandDependencies is specified, the Dependencies property on
nodes will contain the nodes they are dependent on. If
IncludeParents is specified, the ParentNode property on the
CatalogNode will contain the parent node. Leaving a given option
will result in the returned catalog nodes to have null for that
value. Extra data should only be retrieved if it is needed since
computing and sending information can be expensive.
CatalogNode[] queryNodes(java.lang.String[] pathSpecs, com.microsoft.tfs.util.GUID[] resourceTypeFilters, CatalogQueryOptions queryOptions)
pathSpecs
- The paths of the element or elements that are being searched for.
This path can contain the wildcards "*", "**" and "..." where "*"
means one-level and "**" and "..." means any number of levels.resourceTypeFilters
- The list of types that this query should include. If this is null
or empty, all types will be included.queryOptions
- If ExpandDependencies is specified, the Dependencies property on
nodes will contain the nodes they are dependent on. If
IncludeParents is specified, the ParentNode property on the
CatalogNode will contain the parent node. Leaving a given option
will result in the returned catalog nodes to have null for that
value. Extra data should only be retrieved if it is needed since
computing and sending information can be expensive.
CatalogNode[] queryNodes(java.lang.String[] pathSpecs, com.microsoft.tfs.util.GUID[] resourceTypeFilters, CatalogResourceProperty[] propertyFilters, CatalogQueryOptions queryOptions)
pathSpecs
- The paths of the element or elements that are being searched for.
This path can contain the wildcards "*", "**" and "..." where "*"
means one-level and "**" and "..." means any number of levels.resourceTypeFilters
- The list of types that this query should include. If this is null
or empty, all types will be included.propertyFilters
- The set of property filters to apply to the nodes found. Matches
will be based on both the key and the value of the property
matching. If the value of a certain filter is null or empty then
it will be assumed that all nodes with the supplied property
should be returned. A match consists of a node/resource that
matches all of the propertyFilters.queryOptions
- If ExpandDependencies is specified, the Dependencies property on
nodes will contain the nodes they are dependent on. If
IncludeParents is specified, the ParentNode property on the
CatalogNode will contain the parent node. Leaving a given option
will result in the returned catalog nodes to have null for that
value. Extra data should only be retrieved if it is needed since
computing and sending information can be expensive.
CatalogNode[] getRootNodes()
CatalogNode queryRootNode(CatalogTree tree)
tree
- The tree of the desired root.
void saveResource(CatalogResource resource)
resource
- The resource to update.void saveNode(CatalogNode node)
node
- The node that has been created or updated.void saveDelete(CatalogNode node, java.lang.Boolean recurse)
node
- The node to delete.recurse
- True if the children nodes of this node should be deleted.void saveMove(CatalogNode nodeToMove, CatalogNode newParent)
nodeToMove
- The node to move under the newParent.newParent
- The newParent to place nodeToMove under.CatalogChangeContext createChangeContext()
ILocationService getLocationService()
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |