org.dspace.content

Class RelationshipServiceImpl

java.lang.Object

org.dspace.content.RelationshipServiceImpl

All Implemented Interfaces:

RelationshipService, DSpaceCRUDService<Relationship>

public class RelationshipServiceImpl
extends Object
implements RelationshipService

Field Summary

Fields

Modifier and Type	Field and Description
protected AuthorizeService	authorizeService
protected ItemService	itemService
protected RelationshipDAO	relationshipDAO
protected RelationshipTypeService	relationshipTypeService

Constructor Summary

Constructors

Constructor and Description
RelationshipServiceImpl()

Method Summary

Modifier and Type	Method and Description
Relationship	create(Context context)
Relationship	create(Context c, Item leftItem, Item rightItem, RelationshipType relationshipType, int leftPlace, int rightPlace) This method is used to construct a Relationship object with all it's variables
Relationship	create(Context context, Relationship relationship) This method creates a relationship object in the database equal to the given relationship param if this is a valid relationship
void	delete(Context context, Relationship relationship)
Relationship	find(Context context, int id)
List<Relationship>	findAll(Context context) Retrieves the full list of relationships currently in the system
List<Relationship>	findByItem(Context context, Item item) Retrieves the list of Relationships currently in the system for which the given Item is either a leftItem or a rightItem object
List<Relationship>	findByItemAndRelationshipType(Context context, Item item, RelationshipType relationshipType) This method returns a list of Relationships for which the leftItem or rightItem is equal to the given Item object and for which the RelationshipType object is equal to the relationshipType property
List<Relationship>	findByItemAndRelationshipType(Context context, Item item, RelationshipType relationshipType, boolean isLeft)
List<Relationship>	findByRelationshipType(Context context, RelationshipType relationshipType) This method returns a list of Relationship objets for which the relationshipType property is equal to the given RelationshipType object
int	findLeftPlaceByLeftItem(Context context, Item item) Retrieves the highest integer value for the leftplace property of a Relationship for all relationships that have the given item as a left item
int	findRightPlaceByRightItem(Context context, Item item) Retrieves the highest integer value for the rightplace property of a Relationship for all relationships that have the given item as a right item
void	update(Context context, List<Relationship> relationships)
void	update(Context context, Relationship relationship)
void	updateItem(Context context, Item relatedItem) This method will update the given item's metadata order.
void	updatePlaceInRelationship(Context context, Relationship relationship, boolean isCreation) This method will update the place for the Relationship and all other relationships found by the items and relationship type of the given Relatonship.

Methods inherited from class java.lang.Object

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

Field Detail

relationshipDAO

@Autowired(required=true)
protected RelationshipDAO relationshipDAO

authorizeService

@Autowired(required=true)
protected AuthorizeService authorizeService

itemService

@Autowired(required=true)
protected ItemService itemService

relationshipTypeService

@Autowired(required=true)
protected RelationshipTypeService relationshipTypeService

Constructor Detail

RelationshipServiceImpl

public RelationshipServiceImpl()

Method Detail

create

public Relationship create(Context context)
                    throws SQLException,
                           AuthorizeException

Specified by:

create in interface DSpaceCRUDService<Relationship>

Throws:

SQLException

AuthorizeException

create

public Relationship create(Context c,
                           Item leftItem,
                           Item rightItem,
                           RelationshipType relationshipType,
                           int leftPlace,
                           int rightPlace)
                    throws AuthorizeException,
                           SQLException

Description copied from interface: RelationshipService

This method is used to construct a Relationship object with all it's variables

Specified by:

create in interface RelationshipService

Parameters:

c - The relevant DSpace context

leftItem - The leftItem Item object for the relationship

rightItem - The rightItem Item object for the relationship

relationshipType - The RelationshipType object for the relationship

leftPlace - The leftPlace integer for the relationship

rightPlace - The rightPlace integer for the relationship

Returns:

The created Relationship object with the given properties

Throws:

AuthorizeException - If something goes wrong

SQLException - If something goes wrong

create

public Relationship create(Context context,
                           Relationship relationship)
                    throws SQLException,
                           AuthorizeException

Description copied from interface: RelationshipService

This method creates a relationship object in the database equal to the given relationship param if this is a valid relationship

Specified by:

create in interface RelationshipService

Parameters:

context - The relevant DSpace context

relationship - The relationship that will be created in the database if it is valid

Returns:

The created relationship with updated place variables

Throws:

SQLException - If something goes wrong

AuthorizeException - If something goes wrong with authorizations

updatePlaceInRelationship

public void updatePlaceInRelationship(Context context,
                                      Relationship relationship,
                                      boolean isCreation)
                               throws SQLException,
                                      AuthorizeException

Description copied from interface: RelationshipService

This method will update the place for the Relationship and all other relationships found by the items and relationship type of the given Relatonship. It will give this Relationship the last place in both the left and right place determined by querying for the list of leftRelationships and rightRelationships by the leftItem, rightItem and relationshipType of the given Relationship.

Specified by:

updatePlaceInRelationship in interface RelationshipService

Parameters:

context - The relevant DSpace context

relationship - The Relationship object that will have it's place updated and that will be used to retrieve the other relationships whose place might need to be updated

isCreation - Is the relationship new or did it already exist

Throws:

SQLException - If something goes wrong

AuthorizeException

updateItem

public void updateItem(Context context,
                       Item relatedItem)
                throws SQLException,
                       AuthorizeException

Description copied from interface: RelationshipService

This method will update the given item's metadata order. If the relationships for the item have been modified and will calculate the place based on a metadata field, this function will ensure the place is calculated.

Specified by:

updateItem in interface RelationshipService

Parameters:

context - The relevant DSpace context

relatedItem - The Item for which the list of Relationship location is calculated based on a metadata field

Throws:

SQLException - If something goes wrong

AuthorizeException - If the user is not authorized to update the item

findLeftPlaceByLeftItem

public int findLeftPlaceByLeftItem(Context context,
                                   Item item)
                            throws SQLException

Description copied from interface: RelationshipService

Retrieves the highest integer value for the leftplace property of a Relationship for all relationships that have the given item as a left item

Specified by:

findLeftPlaceByLeftItem in interface RelationshipService

Parameters:

context - The relevant DSpace context

item - The item that has to be the leftItem of a relationship for it to qualify

Returns:

The integer value of the highest left place property of all relationships that have the given item as a leftitem property

Throws:

SQLException - If something goes wrong

findRightPlaceByRightItem

public int findRightPlaceByRightItem(Context context,
                                     Item item)
                              throws SQLException

Description copied from interface: RelationshipService

Retrieves the highest integer value for the rightplace property of a Relationship for all relationships that have the given item as a right item

Specified by:

findRightPlaceByRightItem in interface RelationshipService

Parameters:

context - The relevant DSpace context

item - The item that has to be the rightitem of a relationship for it to qualify

Returns:

The integer value of the highest right place property of all relationships that have the given item as a rightitem property

Throws:

SQLException - If something goes wrong

find

public Relationship find(Context context,
                         int id)
                  throws SQLException

Specified by:

find in interface DSpaceCRUDService<Relationship>

Throws:

SQLException

findByItem

public List<Relationship> findByItem(Context context,
                                     Item item)
                              throws SQLException

Description copied from interface: RelationshipService

Retrieves the list of Relationships currently in the system for which the given Item is either a leftItem or a rightItem object

Specified by:

findByItem in interface RelationshipService

Parameters:

context - The relevant DSpace context

item - The Item that has to be the left or right item for the relationship to be included in the list

Returns:

The list of relationships for which each relationship adheres to the above listed constraint

Throws:

SQLException - If something goes wrong

findAll

public List<Relationship> findAll(Context context)
                           throws SQLException

Description copied from interface: RelationshipService

Retrieves the full list of relationships currently in the system

Specified by:

findAll in interface RelationshipService

Parameters:

context - The relevant DSpace context

Returns:

The list of all relationships currently in the system

Throws:

SQLException - If something goes wrong

update

public void update(Context context,
                   Relationship relationship)
            throws SQLException,
                   AuthorizeException

Specified by:

update in interface DSpaceCRUDService<Relationship>

Throws:

SQLException

AuthorizeException

update

public void update(Context context,
                   List<Relationship> relationships)
            throws SQLException,
                   AuthorizeException

Specified by:

update in interface DSpaceCRUDService<Relationship>

Throws:

SQLException

AuthorizeException

delete

public void delete(Context context,
                   Relationship relationship)
            throws SQLException,
                   AuthorizeException

Specified by:

delete in interface DSpaceCRUDService<Relationship>

Throws:

SQLException

AuthorizeException

findByItemAndRelationshipType

public List<Relationship> findByItemAndRelationshipType(Context context,
                                                        Item item,
                                                        RelationshipType relationshipType,
                                                        boolean isLeft)
                                                 throws SQLException

Throws:

SQLException

findByItemAndRelationshipType

public List<Relationship> findByItemAndRelationshipType(Context context,
                                                        Item item,
                                                        RelationshipType relationshipType)
                                                 throws SQLException

Description copied from interface: RelationshipService

This method returns a list of Relationships for which the leftItem or rightItem is equal to the given Item object and for which the RelationshipType object is equal to the relationshipType property

Specified by:

findByItemAndRelationshipType in interface RelationshipService

Parameters:

context - The relevant DSpace context

item - The Item object to be matched on the leftItem or rightItem for the relationship

relationshipType - The RelationshipType object that will be used to check the Relationship on

Returns:

The list of Relationship objects that have the given Item object as leftItem or rightItem and for which the relationshipType property is equal to the given RelationshipType

Throws:

SQLException - If something goes wrong

findByRelationshipType

public List<Relationship> findByRelationshipType(Context context,
                                                 RelationshipType relationshipType)
                                          throws SQLException

Description copied from interface: RelationshipService

This method returns a list of Relationship objets for which the relationshipType property is equal to the given RelationshipType object

Specified by:

findByRelationshipType in interface RelationshipService

Parameters:

context - The relevant DSpace context

relationshipType - The RelationshipType object that will be used to check the Relationship on

Returns:

The list of Relationship objects for which the given RelationshipType object is equal to the relationshipType property

Throws:

SQLException - If something goes wrong