com.adobe.cq.social.srp.utilities.internal

Interface InternalSocialResourceUtilities

public interface InternalSocialResourceUtilities

Field Summary

Fields

Modifier and Type	Field and Description
static String	ASI_UGC_PREFIX The SRP prefix.
static String	PATH_UGC
static String	PN_ATTACHMENT_LIST
static String	PN_BASETYPE
static String	PN_COMMENT_RESOURCETYPE The resources type for comments.
static String	PN_CS_ROOT
static String	PN_DATE The date field name.
static String	PN_DS_KEY
static String	PN_ENTITY
static String	PN_IS_REPLY
static String	PN_PARENTID The key used to describe a parent resource.
static String	SRP_CONFIGURATION_ROOT Where config definitions are stored.
static String	SRP_DEFAULT_CONFIG_PATH

Method Summary

Modifier and Type	Method and Description
String	createUniqueNameHint(String message) Creates a valid and unique JCR Node name given the message.
String	createUniqueNameHint(String message, int numRandomChars) Creates a valid and unique JCR Node name given the message.
String	generateRandomString(int length) Generates a (secure) random string with the given length.
SocialResourceConfiguration	getDefaultStorageConfig() Gets the default configuration set for the system.
String	mapUGCPath(String ugcPath, ResourceResolver resolver) Map a UGC path, avoiding multiple round trips.
String	prepareUserGeneratedContent(ResourceResolver resolver, String path) Prepare user generated content for the specified path.
String	prepareUserGeneratedContentWithLeafTypeHint(ResourceResolver resolver, String path, String typeHint, boolean writeWithResolver) Prepare the needed page paths in /content/usergenerated.

Field Detail

SRP_CONFIGURATION_ROOT

static final String SRP_CONFIGURATION_ROOT

Where config definitions are stored. TODO: Temporary This will change once the config location settles down.

See Also:

Constant Field Values

SRP_DEFAULT_CONFIG_PATH

static final String SRP_DEFAULT_CONFIG_PATH

See Also:

Constant Field Values

PATH_UGC

static final String PATH_UGC

See Also:

Constant Field Values

ASI_UGC_PREFIX

static final String ASI_UGC_PREFIX

The SRP prefix.

See Also:

Constant Field Values

PN_PARENTID

static final String PN_PARENTID

The key used to describe a parent resource.

See Also:

Constant Field Values

PN_BASETYPE

static final String PN_BASETYPE

See Also:

Constant Field Values

PN_CS_ROOT

static final String PN_CS_ROOT

See Also:

Constant Field Values

PN_ATTACHMENT_LIST

static final String PN_ATTACHMENT_LIST

See Also:

Constant Field Values

PN_DS_KEY

static final String PN_DS_KEY

See Also:

Constant Field Values

PN_IS_REPLY

static final String PN_IS_REPLY

See Also:

Constant Field Values

PN_ENTITY

static final String PN_ENTITY

See Also:

Constant Field Values

PN_DATE

static final String PN_DATE

The date field name.

See Also:

Constant Field Values

PN_COMMENT_RESOURCETYPE

static final String PN_COMMENT_RESOURCETYPE

The resources type for comments.

See Also:

Constant Field Values

Method Detail

mapUGCPath

String mapUGCPath(String ugcPath,
                  ResourceResolver resolver)

Map a UGC path, avoiding multiple round trips.

Parameters:

ugcPath - the path to map

resolver - the resolver to use to try and map the path

Returns:

the mapped path

getDefaultStorageConfig

SocialResourceConfiguration getDefaultStorageConfig()

Gets the default configuration set for the system.

Returns:

a configuration for the social data store or null if one does not exist

createUniqueNameHint

String createUniqueNameHint(String message)

Creates a valid and unique JCR Node name given the message. This will include 4 characters of entropy added to prevent similarly named collisions.

Parameters:

message - a starting to point for the name, will be stripped of invalid node name characters.

Returns:

a String with a unique name

createUniqueNameHint

String createUniqueNameHint(String message,
                            int numRandomChars)

Creates a valid and unique JCR Node name given the message. This will the requested amount of of entropy added to prevent similarly named collisions.

Parameters:

message - a starting to point for the name, will be stripped of invalid node name characters.

numRandomChars - the number of characters to add as random noise in the name

Returns:

a String with a unique name

generateRandomString

String generateRandomString(int length)

Generates a (secure) random string with the given length.

Parameters:

length - length of random string.

Returns:

a random string.

prepareUserGeneratedContent

String prepareUserGeneratedContent(ResourceResolver resolver,
                                   String path)
                            throws SocialException

Prepare user generated content for the specified path. The path can be the page path or the ugc collection root.

Parameters:

resolver - The ResourceResolver to use for persisting values.

path - The page path

Returns:

the user generated content page path.

Throws:

SocialException - if error occurs in Social Collaboration

prepareUserGeneratedContentWithLeafTypeHint

String prepareUserGeneratedContentWithLeafTypeHint(ResourceResolver resolver,
                                                   String path,
                                                   String typeHint,
                                                   boolean writeWithResolver)
                                            throws SocialException

Prepare the needed page paths in /content/usergenerated.

Parameters:

resolver - Depending on the value of writeWithResolver, a resolver that can be used to read and/or write the ugc page path

path - The page path

typeHint - the resource type for the last part of the page path or null.

writeWithResolver - If true, resolver can be used to both read and write the UGC page path. If false, resolver can only be used to read the UGC page path. A service user will be used to create it if needed.

Returns:

the user generated content page path.

Throws:

SocialException - on failure