org.wso2.carbon.registry.core.jdbc.dao
Class TagsVersionDAO

java.lang.Object
  extended by org.wso2.carbon.registry.core.jdbc.dao.TagsDAO
      extended by org.wso2.carbon.registry.core.jdbc.dao.TagsVersionDAO

public class TagsVersionDAO
extends TagsDAO

Data Access Object for Tags when auto-versioning for tags has been enabled.


Constructor Summary
TagsVersionDAO()
           
 
Method Summary
 void addTagging(String tagName, ResourceImpl resource, String userID)
          Method to persist a tag.
 void addTaggings(ResourceImpl resource, TaggingDO[] taggingDOs)
          Method to persist tags.
 void copyTags(ResourceImpl fromResource, ResourceImpl toResource)
          Method to copy tags.
 List getPathsWithAnyTag(String[] tags)
          Method to obtain the list of paths having any of the given tags.
 ResourceImpl getResourceWithMinimumData(String path)
          Gets the resource with sufficient data to differentiate it from another resource.
 long getTagCount(ResourceImpl resourceImpl, String tag)
          Method to get the number of tags added to the given resource, by the given name.
 List<TaggingDO> getTagDOs(ResourceImpl resourceImpl)
          Method to get the data objects of tags added to the given resource.
 TaggingDO getTagging(long taggingID)
          Method to get a tagging by the given id.
 TaggingDO[] getTagging(ResourceImpl resource)
          Method to get all taggings added to a given resource.
 TaggingDO[] getTagging(ResourceImpl resource, String tag, String userID)
          Method to get a tagging added to a given resource by the given user.
 String[] getTags(ResourceImpl resourceImpl)
          Method to get the names of tags added to the given resource.
 Tag[] getTagsWithCount(ResourceImpl resourceImpl)
          Method to get tags added to the given resource, along with the count.
 void moveTagPaths(ResourceIDImpl source, ResourceIDImpl target)
          Method to move tag paths.
 void moveTags(ResourceIDImpl source, ResourceIDImpl target)
          Method to move tags.
 boolean taggingExists(String tagName, ResourceImpl resourceImpl, String userID)
          Method to determine whether the given tag exists.
 
Methods inherited from class org.wso2.carbon.registry.core.jdbc.dao.TagsDAO
getPathsWithTag, removeTags, removeTags, removeTags
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

TagsVersionDAO

public TagsVersionDAO()
Method Detail

addTagging

public void addTagging(String tagName,
                       ResourceImpl resource,
                       String userID)
                throws RegistryException
Method to persist a tag.

Overrides:
addTagging in class TagsDAO
Parameters:
resource - the resource
userID - the id of the user who added the tag.
tagName - the name of tag to be persisted.
Throws:
RegistryException - if some error occurs while adding a tag

addTaggings

public void addTaggings(ResourceImpl resource,
                        TaggingDO[] taggingDOs)
                 throws RegistryException
Method to persist tags.

Overrides:
addTaggings in class TagsDAO
Parameters:
resource - the resource
taggingDOs - the tags to be persisted.
Throws:
RegistryException - if some error occurs while adding tags

copyTags

public void copyTags(ResourceImpl fromResource,
                     ResourceImpl toResource)
              throws RegistryException
Method to copy tags.

Overrides:
copyTags in class TagsDAO
Parameters:
fromResource - the source resource.
toResource - the target resource.
Throws:
RegistryException - if some error occurs while copying tags

taggingExists

public boolean taggingExists(String tagName,
                             ResourceImpl resourceImpl,
                             String userID)
                      throws RegistryException
Method to determine whether the given tag exists.

Overrides:
taggingExists in class TagsDAO
Parameters:
resourceImpl - the resource
userID - the id of the user who added the tag.
tagName - the name of tag to be persisted.
Returns:
whether the given tag exists.
Throws:
RegistryException - if some error occurs while checking whether a tag exists.

getTags

public String[] getTags(ResourceImpl resourceImpl)
                 throws RegistryException
Method to get the names of tags added to the given resource.

Overrides:
getTags in class TagsDAO
Parameters:
resourceImpl - the resource.
Returns:
array of tag names.
Throws:
RegistryException - if an error occurs while getting the tag names.

getTagDOs

public List<TaggingDO> getTagDOs(ResourceImpl resourceImpl)
                          throws RegistryException
Method to get the data objects of tags added to the given resource.

Overrides:
getTagDOs in class TagsDAO
Parameters:
resourceImpl - the resource.
Returns:
list of tagging data objects.
Throws:
RegistryException - if an error occurs while getting the tagging data objects.

getPathsWithAnyTag

public List getPathsWithAnyTag(String[] tags)
                        throws RegistryException
Method to obtain the list of paths having any of the given tags.

Overrides:
getPathsWithAnyTag in class TagsDAO
Parameters:
tags - the tags.
Returns:
a list of paths.
Throws:
RegistryException - if an error occurs.

getTagCount

public long getTagCount(ResourceImpl resourceImpl,
                        String tag)
                 throws RegistryException
Method to get the number of tags added to the given resource, by the given name.

Overrides:
getTagCount in class TagsDAO
Parameters:
resourceImpl - the resource.
tag - the tag name
Returns:
the number of tags.
Throws:
RegistryException - if an error occurred while getting the number of tags.

getTagsWithCount

public Tag[] getTagsWithCount(ResourceImpl resourceImpl)
                       throws RegistryException
Method to get tags added to the given resource, along with the count.

Overrides:
getTagsWithCount in class TagsDAO
Parameters:
resourceImpl - the resource.
Returns:
an array of tags (with counts).
Throws:
RegistryException - if an error occurred while getting tags.

getTagging

public TaggingDO[] getTagging(ResourceImpl resource,
                              String tag,
                              String userID)
                       throws RegistryException
Method to get a tagging added to a given resource by the given user.

Overrides:
getTagging in class TagsDAO
Parameters:
resource - the resource.
tag - the name of the tag.
userID - the id of the user who added the tagging.
Returns:
the tagging data objects.
Throws:
RegistryException - if an error occurs while getting the tagging.

getTagging

public TaggingDO[] getTagging(ResourceImpl resource)
                       throws RegistryException
Method to get all taggings added to a given resource.

Overrides:
getTagging in class TagsDAO
Parameters:
resource - the resource.
Returns:
the tagging data objects.
Throws:
RegistryException - if an error occurs while getting the taggings.

getTagging

public TaggingDO getTagging(long taggingID)
                     throws RegistryException
Method to get a tagging by the given id.

Overrides:
getTagging in class TagsDAO
Parameters:
taggingID - the id of the tagging.
Returns:
the tagging data object.
Throws:
RegistryException - if an error occurs while getting the tagging.

getResourceWithMinimumData

public ResourceImpl getResourceWithMinimumData(String path)
                                        throws RegistryException
Gets the resource with sufficient data to differentiate it from another resource. This would populate a ResourceImpl with the path, name and path identifier of a resource.

Overrides:
getResourceWithMinimumData in class TagsDAO
Parameters:
path - the path of the resource.
Returns:
the resource with minimum data.
Throws:
RegistryException - if an error occurs while retrieving resource data.

moveTags

public void moveTags(ResourceIDImpl source,
                     ResourceIDImpl target)
              throws RegistryException
Method to move tags. This function is not applicable to versioned resources.

Overrides:
moveTags in class TagsDAO
Parameters:
source - the source resource.
target - the target resource.
Throws:
RegistryException - if some error occurs while moving tags

moveTagPaths

public void moveTagPaths(ResourceIDImpl source,
                         ResourceIDImpl target)
                  throws RegistryException
Method to move tag paths. This function is not applicable to versioned resources.

Overrides:
moveTagPaths in class TagsDAO
Parameters:
source - the source resource.
target - the target resource.
Throws:
RegistryException - if some error occurs while moving tag paths


Copyright © 2010. All Rights Reserved.