com.communote.server.core.property

Class PropertyManagementImpl

java.lang.Object

com.communote.server.core.property.PropertyManagementImpl

All Implemented Interfaces:

PropertyManagement

@Service(value="propertyManagement")
 @Transactional(propagation=REQUIRED)
public class PropertyManagementImpl
extends Object
implements PropertyManagement

Author:

Communote GmbH - http://www.communote.com/

Field Summary

Fields inherited from interface com.communote.server.api.core.property.PropertyManagement

KEY_GROUP

Constructor Summary

Constructors

Constructor and Description
PropertyManagementImpl()

Method Summary

Modifier and Type	Method and Description
void	addObjectPropertyFilter(PropertyType propertyType, String keyGroup, String propertyKey) Add a combination of a property key group and property key to the accessible properties of the given property type.
Set<StringPropertyTO>	getAllObjectProperties(PropertyType propertyType, Long objectId) Get all filtered properties from a given object for the given property type
BinaryProperty	getBinaryProperty(String keyGroup, String key) Get a binary property not bound to any context
Date	getBinaryPropertyLastModificationDate(String keyGroup, String key) Get last modification date of a binary property.
StringProperty	getGlobalObjectProperty(PropertyType propertyType, Long objectId, String key) Get a global property which is a property with the predefined key group "global"
StringProperty	getObjectProperty(PropertyType propertyType, Long objectId, String keyGroup, String key) Get an object property
StringProperty	getObjectPropertyUnfiltered(PropertyType propertyType, Long objectId, String keyGroup, String key) Get an object property.
<T> Collection<T>	getUsersOfProperty(Long noteId, String keyGroup, String key, String value, Converter<User,T> converter) Return the users that have a specific note property set for a note.
boolean	hasBinaryProperty(String keyGroup, String key) Test whether a binary property exists.
boolean	hasUserNoteProperty(Long noteId, String keyGroup, String key, String value) Test whether the current user has a given property for a note.
void	init() init stuff
void	removeBinaryProperty(String keyGroup, String propertyKey) Remove a binary property.
void	removeObjectPropertyFilter(PropertyType propertyType, String keyGroup, String propertyKey) Remove a combination of a property key group and property key from the accessible properties of the given type.
BinaryProperty	setBinaryProperty(String keyGroup, String key, byte[] value) Set a binary property.
StringProperty	setGlobalObjectProperty(PropertyType propertyType, Long objectId, String key, String value) Set a global property which is a property with the predefined key group will be "global".
void	setObjectProperties(PropertyType propertyType, Long objectId, Set<StringPropertyTO> properties) Set several properties of an object.
StringProperty	setObjectProperty(PropertyType propertyType, Long objectId, String keyGroup, String key, String value) Set a new value of a property.

Methods inherited from class java.lang.Object

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

Constructor Detail

PropertyManagementImpl

public PropertyManagementImpl()

Method Detail

addObjectPropertyFilter

@Transactional(propagation=SUPPORTS)
public void addObjectPropertyFilter(PropertyType propertyType,
                                                                         String keyGroup,
                                                                         String propertyKey)

Description copied from interface: PropertyManagement

Add a combination of a property key group and property key to the accessible properties of the given property type.

Specified by:

addObjectPropertyFilter in interface PropertyManagement

Parameters:

propertyType - the property type

keyGroup - the key group of the property

propertyKey - the key of the property

getAllObjectProperties

public Set<StringPropertyTO> getAllObjectProperties(PropertyType propertyType,
                                                    Long objectId)
                                             throws NotFoundException,
                                                    AuthorizationException

Description copied from interface: PropertyManagement

Get all filtered properties from a given object for the given property type

Specified by:

getAllObjectProperties in interface PropertyManagement

Parameters:

propertyType - the property type

objectId - the object id

Returns:

all filtered properties from the object

Throws:

NotFoundException - in case the object does not exist

AuthorizationException - in case the user is not allowed to access the properties of the object

getBinaryProperty

@Transactional(readOnly=true)
public BinaryProperty getBinaryProperty(String keyGroup,
                                                                      String key)

Description copied from interface: PropertyManagement

Get a binary property not bound to any context

Specified by:

getBinaryProperty in interface PropertyManagement

Parameters:

keyGroup - the key group

key - the key of the property

Returns:

the property (or null)

getBinaryPropertyLastModificationDate

@Transactional(readOnly=true)
public Date getBinaryPropertyLastModificationDate(String keyGroup,
                                                                                String key)

Description copied from interface: PropertyManagement

Get last modification date of a binary property.

Specified by:

getBinaryPropertyLastModificationDate in interface PropertyManagement

Parameters:

keyGroup - group of the property key

key - the key of the property

Returns:

the last modification date or null if the property does not exist

getGlobalObjectProperty

@Transactional(readOnly=true)
public StringProperty getGlobalObjectProperty(PropertyType propertyType,
                                                                            Long objectId,
                                                                            String key)
                                                                     throws NotFoundException,
                                                                            AuthorizationException

Description copied from interface: PropertyManagement

Get a global property which is a property with the predefined key group "global"

Specified by:

getGlobalObjectProperty in interface PropertyManagement

Parameters:

propertyType - the type of property

objectId - the id of the object to get the property for

key - the key of the property

Returns:

the property (or null)

Throws:

NotFoundException - in case there is no object of the given property type and id

AuthorizationException - in case the user is not allowed to access the properties of the object

getObjectProperty

@Transactional(readOnly=true)
public StringProperty getObjectProperty(PropertyType propertyType,
                                                                      Long objectId,
                                                                      String keyGroup,
                                                                      String key)
                                                               throws NotFoundException,
                                                                      AuthorizationException

Description copied from interface: PropertyManagement

Get an object property

Specified by:

getObjectProperty in interface PropertyManagement

Parameters:

propertyType - the type of property

objectId - the ID of the object whose property should be retrieved

keyGroup - the key group of the property

key - the key of the property

Returns:

the property or null if there is no such property or the key and group combination is not in the allowed filters

Throws:

NotFoundException - in case there is no object of the given property type and id

AuthorizationException - in case the user is not allowed to access the properties of the object

getObjectPropertyUnfiltered

@Transactional(readOnly=true)
public StringProperty getObjectPropertyUnfiltered(PropertyType propertyType,
                                                                                Long objectId,
                                                                                String keyGroup,
                                                                                String key)
                                                                         throws NotFoundException,
                                                                                AuthorizationException

Description copied from interface: PropertyManagement

Get an object property. The filter of will not be applied.

Specified by:

getObjectPropertyUnfiltered in interface PropertyManagement

Parameters:

propertyType - the type of property

objectId - the ID of the object whose property should be retrieved

keyGroup - the key group of the property

key - the key of the property

Returns:

the property or null if there is no such property

Throws:

NotFoundException - in case there is no object of the given property type and id

AuthorizationException - in case the user is not allowed to access the properties of the object

getUsersOfProperty

@Transactional(readOnly=true)
public <T> Collection<T> getUsersOfProperty(Long noteId,
                                                                          String keyGroup,
                                                                          String key,
                                                                          String value,
                                                                          Converter<User,T> converter)
                                                                   throws NotFoundException,
                                                                          AuthorizationException

Description copied from interface: PropertyManagement

Return the users that have a specific note property set for a note. The found users are converted into the target type of the provided converter. Deleted users won't be included.

Specified by:

getUsersOfProperty in interface PropertyManagement

Type Parameters:

T - the target type of the conversion

Parameters:

noteId - the ID of the note for which the users that have the property should be returned

keyGroup - the group key of the searched property

key - the group of the searched property

value - the value of the searched property

converter - the converter to convert the found users

Returns:

the found users or an empty list

Throws:

NotFoundException - in case the note does not exist

AuthorizationException - in case the current user is not allowed to read the property

hasBinaryProperty

@Transactional(readOnly=true)
public boolean hasBinaryProperty(String keyGroup,
                                                               String key)

Description copied from interface: PropertyManagement

Test whether a binary property exists.

Specified by:

hasBinaryProperty in interface PropertyManagement

Parameters:

keyGroup - the key group

key - the key of the property

Returns:

True, if this property exists.

hasUserNoteProperty

@Transactional(readOnly=true)
public boolean hasUserNoteProperty(Long noteId,
                                                                 String keyGroup,
                                                                 String key,
                                                                 String value)
                                                          throws NotFoundException,
                                                                 AuthorizationException

Description copied from interface: PropertyManagement

Test whether the current user has a given property for a note.

Specified by:

hasUserNoteProperty in interface PropertyManagement

Parameters:

noteId - the ID of the note for which the existence of the property should be checked

keyGroup - the group key of the searched property

key - the group of the searched property

value - the value of the searched property

Returns:

true if the user has the property otherwise false

Throws:

NotFoundException - in case the note does not exist

AuthorizationException - in case the current user is not allowed to read the property

init

@PostConstruct
public void init()

init stuff

removeBinaryProperty

public void removeBinaryProperty(String keyGroup,
                                 String propertyKey)

Description copied from interface: PropertyManagement

Remove a binary property.

Specified by:

removeBinaryProperty in interface PropertyManagement

Parameters:

keyGroup - The group of the property key.

propertyKey - The properties key.

removeObjectPropertyFilter

@Transactional(propagation=SUPPORTS)
public void removeObjectPropertyFilter(PropertyType propertyType,
                                                                            String keyGroup,
                                                                            String propertyKey)

Description copied from interface: PropertyManagement

Remove a combination of a property key group and property key from the accessible properties of the given type.

Specified by:

removeObjectPropertyFilter in interface PropertyManagement

Parameters:

propertyType - the property type

keyGroup - the key group of the property

propertyKey - the key of the property

setBinaryProperty

public BinaryProperty setBinaryProperty(String keyGroup,
                                        String key,
                                        byte[] value)
                                 throws AuthorizationException

Description copied from interface: PropertyManagement

Set a binary property.

Specified by:

setBinaryProperty in interface PropertyManagement

Parameters:

keyGroup - the key group

key - the key of the property

value - the value to set

Returns:

the property

Throws:

AuthorizationException - in case the user is not allowed to access the properties of the object

setGlobalObjectProperty

public StringProperty setGlobalObjectProperty(PropertyType propertyType,
                                              Long objectId,
                                              String key,
                                              String value)
                                       throws NotFoundException,
                                              AuthorizationException

Description copied from interface: PropertyManagement

Set a global property which is a property with the predefined key group will be "global".

Specified by:

setGlobalObjectProperty in interface PropertyManagement

Parameters:

propertyType - the type of property

objectId - the id of the object to set the property for

key - the key of the property

value - the value to set

Returns:

the property

Throws:

NotFoundException - in case there is no object of the given property type and id

AuthorizationException - in case the user is not allowed to access the properties of the object

setObjectProperties

public void setObjectProperties(PropertyType propertyType,
                                Long objectId,
                                Set<StringPropertyTO> properties)
                         throws NotFoundException,
                                AuthorizationException

Description copied from interface: PropertyManagement

Set several properties of an object.

Specified by:

setObjectProperties in interface PropertyManagement

Parameters:

propertyType - the type of property

objectId - the id of the object to set the property for

properties - Set of transfer objects describing the new properties or property values

Throws:

NotFoundException - in case there is no object of the given property type and id

AuthorizationException - in case the user is not allowed to access the properties of the object

setObjectProperty

public StringProperty setObjectProperty(PropertyType propertyType,
                                        Long objectId,
                                        String keyGroup,
                                        String key,
                                        String value)
                                 throws NotFoundException,
                                        AuthorizationException

Description copied from interface: PropertyManagement

Set a new value of a property. If the property does not exist it will be created and assigned to the object. If the value to set is null, an existing property will be removed. In case the property does not exist nothing will happen.

Specified by:

setObjectProperty in interface PropertyManagement

Parameters:

propertyType - the type of property

objectId - the id of the object to set the property for

keyGroup - the key group of the property

key - the key of the property

value - the value to set. Can be null to remove an existing property.

Returns:

the created or modified property. Can be null if the value was null and the property did not exist.

Throws:

NotFoundException - in case there is no object of the given property type and id

AuthorizationException - in case the user is not allowed to access the properties of the object