org.cyclos.impl.users

Interface ProfileFieldHandler

public interface ProfileFieldHandler

Handler interface for profile fields permissions, which come from products

Author:

jcomas, luis

Method Summary

Modifier and Type	Method and Description
void	fill(DataWithBasicProfileFields data) Fills properties in search data with basic profile fields
void	filterEnabledForUser(BasicUser user, org.cyclos.impl.utils.BooleanPropertiesHolder<ProfileField> holder) Removes from the given BooleanPropertiesHolder all profile fields which are not enabled for the given user
java.util.List<ProfileField>	getAllProfileFields() Returns a list containing all ProfileField - all BasicProfileFields and all UserCustomFields
java.util.List<UserCustomField>	getCustomFields(java.util.Collection<? extends ProfileField> profileFields) Returns a list containing only the custom fields from the list of profile fields
java.util.List<ProfileField>	getEnabledProfileFields(BasicUser user) Returns the list of profile fields that are enabled in the given user
java.util.List<UserProfileFieldActions>	getFieldActions(BasicUser user) Returns the enabled fields for the given user (and visible to the logged user) and the actions that the logged user can perform over them The contexts which can be used are: - Internal or public registration: the given user should be transient - The logged user is viewing other user's profile.
java.util.Set<ProfileFieldAction>	getFieldActions(BasicUser user, ProfileField profileField) Returns the possible actions over the given user's profile field
java.util.Map<ProfileField,java.util.Set<ProfileFieldAction>>	getFieldActionsMap(BasicUser user) Returns, per profile field, the actions over fields of the given user by the logged user
java.util.List<ProfileField>	getFieldsByAction(BasicUser user, ProfileFieldAction action) Returns the profile fields which are enabled for the given action by the logged user over the given user
org.cyclos.impl.users.FieldsContext	getFieldsContext(BasicUser user) Returns the context (or functionality) where the fields are being displayed
java.lang.Object	getFieldValue(BasicUser user, ProfileField profileField) Returns the value of the given profle field for the given user.
java.util.List<ProfileField>	getMatchingFields(org.cyclos.impl.utils.BooleanPropertiesHolder<ProfileField> holder, com.querydsl.core.types.dsl.BooleanPath path) Like getMatchingFields(BooleanPropertiesHolder, Map), but using a single property which must be true
java.util.List<ProfileField>	getMatchingFields(org.cyclos.impl.utils.BooleanPropertiesHolder<ProfileField> holder, com.querydsl.core.types.dsl.BooleanPath path, java.lang.Boolean filter) Like getMatchingFields(BooleanPropertiesHolder, Map), but using a single property
java.util.List<ProfileField>	getMatchingFields(org.cyclos.impl.utils.BooleanPropertiesHolder<ProfileField> holder, java.util.Map<com.querydsl.core.types.dsl.BooleanPath,java.lang.Boolean> filter) Returns a list of the enabled profile fields that matches all the given filters in the map: for each map key, retains only fields whose that boolean flag is the same as the map value.
java.util.List<ProductMyProfileFieldDTO>	getMyProfileFields(org.cyclos.impl.users.ProductAccessor products) Returns the aggregate my profile fields for the given products accessor.
java.lang.String	getPrincipal(BasicUser basicUser, PrincipalType principalType) Returns the value of the given principal type for the given user, making sure it applies to the user.
ProfileField	getProfileFieldFor(PrincipalType principalType) Returns the profile field corresponding to the given principal type, or null if not applicable
java.util.Map<java.lang.String,java.lang.String>	getProfileFieldVariables(BasicUser user) Returns a map with each profile field identifier and value: If it's a basic profile field (e.g: name, username, etc..) the identifier will be the alias If it's a custom profile field the identifier will be the internal name.
java.util.List<ProfileField>	getSearchFilters(org.cyclos.impl.users.ProfileFieldSearchContext context, boolean searchOverBrokeredUsers) Returns the profile fields that can be used as filters in a search, according to the given context
java.util.List<ProductUserProfileFieldDTO>	getUserProfileFields(org.cyclos.impl.users.ProductAccessor products) Returns the aggregate user profile fields for the given products accessor.
boolean	isAllowed(BasicUser user, ProfileField profileField, ProfileFieldAction action) Returns whether the given action is allowed for the given field / user
boolean	isDefaultHidden(Group group, ProfileField profileField) Returns whether the given field is marked as hidden for the given group configuration.
boolean	isEnabled(BasicUser user, ProfileField profileField) Returns whether the given profile field is enabled for the given products accessor
boolean	isHidden(User user, ProfileField profileField) Returns whether the given field is marked as hidden for the given user.
void	prepareNew(User user) Sets all default profile field visibilities, as well as creates an empty UserCustomFieldValue with the default value set
PrincipalType	principalTypeFor(ProfileField profileField) Returns the principal type associated with the given profile field, or null if none matches
java.util.List<ProfileField>	toEntities(java.util.Collection<ProfileField> profileFields) Converts a list of profile fields to entities.
ProfileField	toEntity(ProfileField field) Returns a profile field compatible to storing as an entity, converting UserCustomFieldVOs to UserCustomFields.
ProfileField	toVO(ProfileField field) Returns a profile field compatible to send to client, converting UserCustomFields to CustomFieldDetailedVOs.
java.util.List<ProfileField>	toVOs(java.util.Collection<ProfileField> profileFields) Converts a list of profile fields to VOs.

Method Detail

fill

void fill(DataWithBasicProfileFields data)

Fills properties in search data with basic profile fields

filterEnabledForUser

void filterEnabledForUser(BasicUser user,
                          org.cyclos.impl.utils.BooleanPropertiesHolder<ProfileField> holder)

Removes from the given BooleanPropertiesHolder all profile fields which are not enabled for the given user

getAllProfileFields

java.util.List<ProfileField> getAllProfileFields()

Returns a list containing all ProfileField - all BasicProfileFields and all UserCustomFields

getCustomFields

java.util.List<UserCustomField> getCustomFields(java.util.Collection<? extends ProfileField> profileFields)

Returns a list containing only the custom fields from the list of profile fields

getEnabledProfileFields

java.util.List<ProfileField> getEnabledProfileFields(BasicUser user)

Returns the list of profile fields that are enabled in the given user

getFieldActions

java.util.List<UserProfileFieldActions> getFieldActions(BasicUser user)

Returns the enabled fields for the given user (and visible to the logged user) and the actions that the logged user can perform over them The contexts which can be used are: - Internal or public registration: the given user should be transient - The logged user is viewing other user's profile. - The logged user is viewing his own profile, in which case the parameter should be the logged user.

getFieldActions

java.util.Set<ProfileFieldAction> getFieldActions(BasicUser user,
                                                  ProfileField profileField)

Returns the possible actions over the given user's profile field

See Also:

#getFieldActions(User)

getFieldActionsMap

java.util.Map<ProfileField,java.util.Set<ProfileFieldAction>> getFieldActionsMap(BasicUser user)

Returns, per profile field, the actions over fields of the given user by the logged user

See Also:

#getFieldActions(User)

getFieldsByAction

java.util.List<ProfileField> getFieldsByAction(BasicUser user,
                                               ProfileFieldAction action)

Returns the profile fields which are enabled for the given action by the logged user over the given user

getFieldsContext

org.cyclos.impl.users.FieldsContext getFieldsContext(BasicUser user)

Returns the context (or functionality) where the fields are being displayed

getFieldValue

java.lang.Object getFieldValue(BasicUser user,
                               ProfileField profileField)
                        throws FrameworkException

Returns the value of the given profle field for the given user. The value depends on the profile field type:

• BasicProfileField.LOGIN_NAME, BasicProfileField.FULL_NAME, BasicProfileField.EMAIL: Returns a string with the value
• BasicProfileField.PHONE, BasicProfileField.ADDRESS, BasicProfileField.IMAGE: Returns a collection with the entities
• BasicProfileField.ACCOUNT_NUMBER: Returns a collection with the unmasked strings for all active accounts
• Custom field: Returns the custom field value. See CustomFieldHelper.getValue(Long, Collection)

Throws:

FrameworkException

getMatchingFields

java.util.List<ProfileField> getMatchingFields(org.cyclos.impl.utils.BooleanPropertiesHolder<ProfileField> holder,
                                               com.querydsl.core.types.dsl.BooleanPath path)

Like getMatchingFields(BooleanPropertiesHolder, Map), but using a single property which must be true

getMatchingFields

java.util.List<ProfileField> getMatchingFields(org.cyclos.impl.utils.BooleanPropertiesHolder<ProfileField> holder,
                                               com.querydsl.core.types.dsl.BooleanPath path,
                                               java.lang.Boolean filter)

Like getMatchingFields(BooleanPropertiesHolder, Map), but using a single property

getMatchingFields

java.util.List<ProfileField> getMatchingFields(org.cyclos.impl.utils.BooleanPropertiesHolder<ProfileField> holder,
                                               java.util.Map<com.querydsl.core.types.dsl.BooleanPath,java.lang.Boolean> filter)

Returns a list of the enabled profile fields that matches all the given filters in the map: for each map key, retains only fields whose that boolean flag is the same as the map value.

getMyProfileFields

java.util.List<ProductMyProfileFieldDTO> getMyProfileFields(org.cyclos.impl.users.ProductAccessor products)

Returns the aggregate my profile fields for the given products accessor. Should not be called when there is an user, only for general products.

getPrincipal

java.lang.String getPrincipal(BasicUser basicUser,
                              PrincipalType principalType)

Returns the value of the given principal type for the given user, making sure it applies to the user. If the principal type is not applicable, or the given user has no value for it, returns null.

getProfileFieldFor

ProfileField getProfileFieldFor(PrincipalType principalType)

Returns the profile field corresponding to the given principal type, or null if not applicable

getProfileFieldVariables

java.util.Map<java.lang.String,java.lang.String> getProfileFieldVariables(BasicUser user)

Returns a map with each profile field identifier and value: If it's a basic profile field (e.g: name, username, etc..) the identifier will be the alias If it's a custom profile field the identifier will be the internal name.

getSearchFilters

java.util.List<ProfileField> getSearchFilters(org.cyclos.impl.users.ProfileFieldSearchContext context,
                                              boolean searchOverBrokeredUsers)

Returns the profile fields that can be used as filters in a search, according to the given context

getUserProfileFields

java.util.List<ProductUserProfileFieldDTO> getUserProfileFields(org.cyclos.impl.users.ProductAccessor products)

Returns the aggregate user profile fields for the given products accessor. Should not be called when there is an user, only for general products.

isAllowed

boolean isAllowed(BasicUser user,
                  ProfileField profileField,
                  ProfileFieldAction action)

Returns whether the given action is allowed for the given field / user

isDefaultHidden

boolean isDefaultHidden(Group group,
                        ProfileField profileField)
                 throws FrameworkException

Returns whether the given field is marked as hidden for the given group configuration.

Throws:

FrameworkException

isEnabled

boolean isEnabled(BasicUser user,
                  ProfileField profileField)

Returns whether the given profile field is enabled for the given products accessor

isHidden

boolean isHidden(User user,
                 ProfileField profileField)
          throws FrameworkException

Returns whether the given field is marked as hidden for the given user. Does not take into account the logged user permissions, is the raw hidden state.

Throws:

FrameworkException

prepareNew

void prepareNew(User user)
         throws FrameworkException

Sets all default profile field visibilities, as well as creates an empty UserCustomFieldValue with the default value set

Throws:

FrameworkException

principalTypeFor

PrincipalType principalTypeFor(ProfileField profileField)

Returns the principal type associated with the given profile field, or null if none matches

toEntities

java.util.List<ProfileField> toEntities(java.util.Collection<ProfileField> profileFields)

Converts a list of profile fields to entities.

See Also:

toEntity(ProfileField)

toEntity

ProfileField toEntity(ProfileField field)

Returns a profile field compatible to storing as an entity, converting UserCustomFieldVOs to UserCustomFields.

toVO

ProfileField toVO(ProfileField field)

Returns a profile field compatible to send to client, converting UserCustomFields to CustomFieldDetailedVOs.

toVOs

java.util.List<ProfileField> toVOs(java.util.Collection<ProfileField> profileFields)

Converts a list of profile fields to VOs.

See Also:

toVO(ProfileField)