org.exoplatform.outlook

Class OutlookServiceImpl

java.lang.Object

org.exoplatform.outlook.OutlookServiceImpl

All Implemented Interfaces:

OutlookService, org.picocontainer.Startable

public class OutlookServiceImpl
extends Object
implements OutlookService, org.picocontainer.Startable

Service implementing OutlookService and Startable.
Created by The eXo Platform SAS.

Version:

$Id: AnaplanServiceImpl.java 00000 Mar 3, 2016 pnedonosko $

Author:

Peter Nedonosko

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected class	OutlookServiceImpl.OutlookSpaceImpl The Class OutlookSpaceImpl.
protected class	OutlookServiceImpl.PersonalDocuments The Class PersonalDocuments.
protected class	OutlookServiceImpl.UserFile The Class UserFile.
protected class	OutlookServiceImpl.UserFolder The Class UserFolder.
protected class	OutlookServiceImpl.UserImpl The Class UserImpl.

Field Summary

Fields

Modifier and Type	Field and Description
protected static com.ibm.icu.text.Transliterator	accentsConverter The Constant accentsConverter.
protected org.owasp.html.PolicyFactory	activityPolicy Custom policy to allow supported elements in activity text as described in Platform User Guide
protected org.exoplatform.services.cms.documents.DocumentService	documentService The resource document service.
protected org.exoplatform.services.cms.drives.ManageDriveService	driveService The drive service.
protected static String	EXO_PRIVILEGEABLE The Constant EXO_PRIVILEGEABLE.
protected NodeFinder	finder The finder.
protected org.exoplatform.services.jcr.ext.hierarchy.NodeHierarchyCreator	hierarchyCreator The hierarchy creator.
protected org.owasp.html.PolicyFactory	htmlPolicy The html policy.
protected org.exoplatform.services.jcr.RepositoryService	jcrService The jcr service.
protected Pattern	linkNotLocal The link with href not a hash in local document target.
protected Pattern	linkWithoutTarget The link without target.
protected Pattern	linkWithTarget The link with target.
protected org.exoplatform.services.listener.ListenerService	listenerService The listener service.
protected static org.exoplatform.services.log.Log	LOG The Constant LOG.
static String	MAILSERVER_URL The Constant MAILSERVER_URL.
protected MailAPI	mailserverApi The mailserver api.
protected static String[]	MANAGER_PERMISSION The Constant MANAGER_PERMISSION.
protected org.exoplatform.services.organization.OrganizationService	organization The organization.
protected static String	OUTLOOK_MESSAGES_NAME The Constant OUTLOOK_MESSAGES_NAME.
protected static String	OUTLOOK_MESSAGES_TITLE The Constant OUTLOOK_MESSAGES_TITLE.
protected static String	PERSONAL_DOCUMENTS The Constant PERSONAL_DOCUMENTS.
protected static Random	RANDOM The Constant RANDOM.
protected static String[]	READER_PERMISSION The Constant READER_PERMISSION.
protected org.exoplatform.services.resources.ResourceBundleService	resourceBundleService The resource bundle service.
protected static String	ROOT_USER The Constant ROOT_USER.
protected org.exoplatform.services.jcr.ext.app.SessionProviderService	sessionProviders The session providers.
protected ConcurrentHashMap<String,OutlookServiceImpl.OutlookSpaceImpl>	spaces Spaces cache.
protected static String	SPACES_HOME The Constant SPACES_HOME.
protected org.owasp.html.PolicyFactory	textPolicy The text policy.
protected String	trashHomePath The trash home path.
protected org.exoplatform.services.cms.documents.TrashService	trashService The trash service.
protected static String	UPLAODS_FOLDER_TITLE The Constant UPLAODS_FOLDER_TITLE.

Fields inherited from interface org.exoplatform.outlook.OutlookService

GROUP_DRIVE_PARRTEN, MESSAGE_NODETYPE, PERSONAL_DRIVE_PARRTEN

Constructor Summary

Constructors

Constructor and Description

OutlookServiceImpl(org.exoplatform.services.jcr.RepositoryService jcrService, org.exoplatform.services.jcr.ext.app.SessionProviderService sessionProviders, org.exoplatform.services.jcr.ext.hierarchy.NodeHierarchyCreator hierarchyCreator, NodeFinder finder, org.exoplatform.services.organization.OrganizationService organization, org.exoplatform.services.listener.ListenerService listenerService, org.exoplatform.services.cms.drives.ManageDriveService driveService, org.exoplatform.services.cms.documents.TrashService trashService, org.exoplatform.services.resources.ResourceBundleService resourceBundleService, org.exoplatform.container.xml.InitParams params, org.exoplatform.services.cms.documents.DocumentService documentService) Outlook service with storage in JCR and with managed features.

Method Summary

Modifier and Type	Method and Description
protected javax.jcr.Node	addFile(javax.jcr.Node parent, String title, String contentType, InputStream content) Add nt:file node for given content stream and title.
protected javax.jcr.Node	addFolder(javax.jcr.Node parent, String title, boolean forceNew) Add nt:folder node with given title.
protected javax.jcr.Node	addMessageFile(javax.jcr.Node parent, OutlookMessage message) Adds the message file.
OutlookMessage	buildMessage(String id, OutlookUser user, OutlookEmail from, List<OutlookEmail> to, Calendar created, Calendar modified, String title, String subject, String body) Build Outlook message object.
protected boolean	checkout(javax.jcr.Node node) Checkout.
protected boolean	checkRootFolderExistence(org.exoplatform.social.core.space.model.Space socialSpace) Checks the root folder existence.
static String	cleanName(String name) Make JCR compatible item name.
protected String	currentUserId() Current user id.
protected Locale	currentUserLocale() Current user locale.
protected javax.jcr.Property	data(javax.jcr.Node content) Data.
protected void	fetchQuery(javax.jcr.query.QueryResult qr, int limit, Set<File> res) Fetch query.
protected void	fetchQuery(javax.jcr.query.QueryResult qr, int limit, Set<File> res, Predicate<javax.jcr.Node> acceptNode) Fetch query.
protected UUID	generateId(String workspace, String path) Generate id.
OutlookEmail	getAddress(String email, String displayName) Build Outlook Email address object.
protected org.exoplatform.services.organization.User	getExoUser(String userName) Gets the exo user.
OutlookMessage	getMessage(OutlookUser user, String messageId, String messageToken) Read Outlook message from server.
OutlookSpace	getSpace(String groupId) Return Office space handler.
OutlookUser	getUser(String email, String displayName, String ewsUrl) Build Outlook user object and associate it with current user in eXo organization.
UserDocuments	getUserDocuments() Gets current user Personal Documents.
List<OutlookSpace>	getUserSpaces() Gets the user spaces.
protected String	groupDocsPath(String groupId) Generate the group documents (as /Groups/spaces/$SPACE_GROUP_ID/Documents).
protected String	groupPath(String groupId) Generate the group node path (as /Groups/spaces/$SPACE_GROUP_ID).
protected void	initDocumentLink(OutlookServiceImpl.PersonalDocuments personalDocuments, HierarchyNode file) Inits the document link.
protected void	initDocumentLink(OutlookSpace space, HierarchyNode file) Inits the document link.
protected void	initDocumentLink(org.exoplatform.portal.mop.SiteType siteType, String driveName, String portalName, String nodeURI, HierarchyNode node) Inits the document link.
protected void	initWebDAVLink(HierarchyNode node) Inits the web DAV link.
protected boolean	isHTML(String content) Try detect is it a HTML content in the string.
protected boolean	isNotNull(org.exoplatform.ws.frameworks.json.value.JsonValue json) Checks if is not null.
protected boolean	isNull(org.exoplatform.ws.frameworks.json.value.JsonValue json) Checks if is null.
protected String	makeLinksOpenNewWindow(String text) Make links open new window.
protected javax.jcr.Node	messagesFolder(javax.jcr.Node parent, String... identity) Messages folder.
protected String	messageSummary(OutlookMessage message) Generate message summary text.
protected String	mimeType(javax.jcr.Node content) Mime type.
protected javax.jcr.Node	node(String nodePath) Node.
protected javax.jcr.Node	node(String workspace, String path) Node.
protected javax.jcr.Node	nodeContent(javax.jcr.Node node) Node content.
protected Calendar	nodeCreated(javax.jcr.Node node) Node created.
protected String	nodeTitle(javax.jcr.Node node) Node title.
protected org.exoplatform.social.core.activity.model.ExoSocialActivity	postAttachmentActivity(Folder destFolder, List<File> files, OutlookUser user, String comment) Post attachment activity.
protected OutlookEmail	readEmail(org.exoplatform.ws.frameworks.json.value.JsonValue vElem) Read email.
protected String	safeActivityMessage(String text) Allow only activity tags as described in https://www.exoplatform.com/docs/PLF43/PLFUserGuide.GettingStarted.ActivitiesInActivityStream.HTMLTags.
protected String	safeHtml(String content) Allow full rage of HTML text and structures.
protected String	safeText(String content) Allow only plain text.
List<File>	saveAttachment(Folder destFolder, OutlookUser user, String comment, String messageId, String attachmentToken, String... attachmentIds) Save attachment.
List<File>	saveAttachment(OutlookSpace space, Folder destFolder, OutlookUser user, String comment, String messageId, String attachmentToken, String... attachmentIds) Save attachment.
protected void	setPermissions(javax.jcr.Node node, boolean deep, boolean forcePrivilegeable, String... identities) Set read permissions on the target node to all given identities (e.g.
protected void	setPermissions(javax.jcr.Node node, String... identities) Set read permissions on the target node to all given identities (e.g.
protected org.exoplatform.social.core.manager.ActivityManager	socialActivityManager() Social activity manager.
protected org.exoplatform.social.core.manager.IdentityManager	socialIdentityManager() Social identity manager.
protected org.exoplatform.social.core.manager.RelationshipManager	socialRelationshipManager() Social relationship manager.
protected javax.jcr.Node	spaceDocumentsNode(String groupId) Find given group Documents folder using current user session.
protected org.exoplatform.social.core.space.spi.SpaceService	spaceService() Space service.
void	start() On-start initializer.
void	stop() On-stop finalizer.
protected javax.jcr.Node	systemNode(String workspace, String path) System node.
protected String	userDocsPath(String userId) Generate the user documents (as /Users/${userId}/Private/Documents).
protected javax.jcr.Node	userDocumentsNode(String userName) Find given user Personal Documents folder using user session.
protected List<OutlookSpace>	userSpaces(String userId) User spaces.

Methods inherited from class java.lang.Object

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

Field Detail

MAILSERVER_URL

public static final String MAILSERVER_URL

The Constant MAILSERVER_URL.

See Also:

Constant Field Values

EXO_PRIVILEGEABLE

protected static final String EXO_PRIVILEGEABLE

The Constant EXO_PRIVILEGEABLE.

See Also:

Constant Field Values

OUTLOOK_MESSAGES_TITLE

protected static final String OUTLOOK_MESSAGES_TITLE

The Constant OUTLOOK_MESSAGES_TITLE.

See Also:

Constant Field Values

OUTLOOK_MESSAGES_NAME

protected static final String OUTLOOK_MESSAGES_NAME

The Constant OUTLOOK_MESSAGES_NAME.

See Also:

Constant Field Values

UPLAODS_FOLDER_TITLE

protected static final String UPLAODS_FOLDER_TITLE

The Constant UPLAODS_FOLDER_TITLE.

See Also:

Constant Field Values

SPACES_HOME

protected static final String SPACES_HOME

The Constant SPACES_HOME.

See Also:

Constant Field Values

ROOT_USER

protected static final String ROOT_USER

The Constant ROOT_USER.

See Also:

Constant Field Values

PERSONAL_DOCUMENTS

protected static final String PERSONAL_DOCUMENTS

The Constant PERSONAL_DOCUMENTS.

See Also:

Constant Field Values

READER_PERMISSION

protected static final String[] READER_PERMISSION

The Constant READER_PERMISSION.

MANAGER_PERMISSION

protected static final String[] MANAGER_PERMISSION

The Constant MANAGER_PERMISSION.

LOG

protected static final org.exoplatform.services.log.Log LOG

The Constant LOG.

RANDOM

protected static final Random RANDOM

The Constant RANDOM.

accentsConverter

protected static final com.ibm.icu.text.Transliterator accentsConverter

The Constant accentsConverter.

jcrService

protected final org.exoplatform.services.jcr.RepositoryService jcrService

The jcr service.

sessionProviders

protected final org.exoplatform.services.jcr.ext.app.SessionProviderService sessionProviders

The session providers.

finder

protected final NodeFinder finder

The finder.

hierarchyCreator

protected final org.exoplatform.services.jcr.ext.hierarchy.NodeHierarchyCreator hierarchyCreator

The hierarchy creator.

organization

protected final org.exoplatform.services.organization.OrganizationService organization

The organization.

driveService

protected final org.exoplatform.services.cms.drives.ManageDriveService driveService

The drive service.

listenerService

protected final org.exoplatform.services.listener.ListenerService listenerService

The listener service.

trashService

protected final org.exoplatform.services.cms.documents.TrashService trashService

The trash service.

resourceBundleService

protected final org.exoplatform.services.resources.ResourceBundleService resourceBundleService

The resource bundle service.

documentService

protected final org.exoplatform.services.cms.documents.DocumentService documentService

The resource document service.

htmlPolicy

protected final org.owasp.html.PolicyFactory htmlPolicy

The html policy.

textPolicy

protected final org.owasp.html.PolicyFactory textPolicy

The text policy.

activityPolicy

protected final org.owasp.html.PolicyFactory activityPolicy

Custom policy to allow supported elements in activity text as described in Platform User Guide

linkNotLocal

protected final Pattern linkNotLocal

The link with href not a hash in local document target.

linkWithTarget

protected final Pattern linkWithTarget

The link with target.

linkWithoutTarget

protected final Pattern linkWithoutTarget

The link without target.

spaces

protected final ConcurrentHashMap<String,OutlookServiceImpl.OutlookSpaceImpl> spaces

Spaces cache. TODO There is an issue with threads when different requests reuse them. Space's root node may be already invalid. See also in getRootFolder().

mailserverApi

protected MailAPI mailserverApi

The mailserver api.

trashHomePath

protected String trashHomePath

The trash home path.

Constructor Detail

OutlookServiceImpl

public OutlookServiceImpl(org.exoplatform.services.jcr.RepositoryService jcrService,
                          org.exoplatform.services.jcr.ext.app.SessionProviderService sessionProviders,
                          org.exoplatform.services.jcr.ext.hierarchy.NodeHierarchyCreator hierarchyCreator,
                          NodeFinder finder,
                          org.exoplatform.services.organization.OrganizationService organization,
                          org.exoplatform.services.listener.ListenerService listenerService,
                          org.exoplatform.services.cms.drives.ManageDriveService driveService,
                          org.exoplatform.services.cms.documents.TrashService trashService,
                          org.exoplatform.services.resources.ResourceBundleService resourceBundleService,
                          org.exoplatform.container.xml.InitParams params,
                          org.exoplatform.services.cms.documents.DocumentService documentService)
                   throws org.exoplatform.container.configuration.ConfigurationException,
                          MailServerException

Outlook service with storage in JCR and with managed features.

Parameters:

jcrService - RepositoryService

sessionProviders - SessionProviderService

hierarchyCreator - NodeHierarchyCreator

finder - NodeFinder

organization - OrganizationService

listenerService - ListenerService

driveService - ManageDriveService

trashService - TrashService

resourceBundleService - ResourceBundleService

params - InitParams

Throws:

org.exoplatform.container.configuration.ConfigurationException - when parameters configuration error

MailServerException - when Mail server API error

Method Detail

saveAttachment

public List<File> saveAttachment(OutlookSpace space,
                                 Folder destFolder,
                                 OutlookUser user,
                                 String comment,
                                 String messageId,
                                 String attachmentToken,
                                 String... attachmentIds)
                          throws OutlookException,
                                 javax.jcr.RepositoryException

Save attachment.

Specified by:

saveAttachment in interface OutlookService

Parameters:

space - the space

destFolder - the folder

user - the user

comment - the comment

messageId - the message id

attachmentToken - the attachment token

attachmentIds - the attachment ids

Returns:

the list

Throws:

OutlookException - the outlook exception

javax.jcr.RepositoryException - the repository exception

saveAttachment

public List<File> saveAttachment(Folder destFolder,
                                 OutlookUser user,
                                 String comment,
                                 String messageId,
                                 String attachmentToken,
                                 String... attachmentIds)
                          throws OutlookException,
                                 javax.jcr.RepositoryException

Save attachment.

Specified by:

saveAttachment in interface OutlookService

Parameters:

destFolder - the dest folder

user - the user

comment - the comment

messageId - the message id

attachmentToken - the attachment token

attachmentIds - the attachment ids

Returns:

the list

Throws:

OutlookException - the outlook exception

javax.jcr.RepositoryException - the repository exception

getAddress

public OutlookEmail getAddress(String email,
                               String displayName)
                        throws OutlookException

Build Outlook Email address object.

Specified by:

getAddress in interface OutlookService

Parameters:

email - email

displayName - user display name

Returns:

OutlookEmail

Throws:

OutlookException - when error

getUser

public OutlookUser getUser(String email,
                           String displayName,
                           String ewsUrl)
                    throws OutlookException,
                           javax.jcr.RepositoryException

Build Outlook user object and associate it with current user in eXo organization.

Specified by:

getUser in interface OutlookService

Parameters:

email - the email

displayName - the user name

ewsUrl - the Exchange server web-service URL

Returns:

OutlookUser object to access Outlook Mail API

Throws:

OutlookException - Outlook exception

javax.jcr.RepositoryException - storage exception

buildMessage

public OutlookMessage buildMessage(String id,
                                   OutlookUser user,
                                   OutlookEmail from,
                                   List<OutlookEmail> to,
                                   Calendar created,
                                   Calendar modified,
                                   String title,
                                   String subject,
                                   String body)
                            throws OutlookException

Build Outlook message object.

Specified by:

buildMessage in interface OutlookService

Parameters:

id - String email message ID

user - OutlookUser

from - OutlookEmail

to - OutlookEmail

created - Calendar

modified - Calendar

title - the title

subject - String message subject

body - String message body

Returns:

OutlookMessage

Throws:

OutlookException - when error

getMessage

public OutlookMessage getMessage(OutlookUser user,
                                 String messageId,
                                 String messageToken)
                          throws OutlookException

Read Outlook message from server.

Specified by:

getMessage in interface OutlookService

Parameters:

user - OutlookUser

messageId - String email message ID

messageToken - String secure token to access message on Exchange server

Returns:

OutlookMessage

Throws:

OutlookException - when error

start

public void start()

On-start initializer.

Specified by:

start in interface org.picocontainer.Startable

stop

public void stop()

On-stop finalizer.

Specified by:

stop in interface org.picocontainer.Startable

getSpace

public OutlookSpace getSpace(String groupId)
                      throws OutlookSpaceException,
                             javax.jcr.RepositoryException,
                             OutlookException

Return Office space handler.

Specified by:

getSpace in interface OutlookService

Parameters:

groupId - String email message ID

Returns:

OutlookSpace

Throws:

OutlookSpaceException - when space access error happen

javax.jcr.RepositoryException - when storage error

OutlookException - when error

getUserSpaces

public List<OutlookSpace> getUserSpaces()
                                 throws OutlookSpaceException

Gets the user spaces.

Specified by:

getUserSpaces in interface OutlookService

Returns:

the user spaces

Throws:

OutlookSpaceException - the outlook space exception

getUserDocuments

public UserDocuments getUserDocuments()
                               throws javax.jcr.RepositoryException,
                                      OutlookException

Gets current user Personal Documents.

Specified by:

getUserDocuments in interface OutlookService

Returns:

the user documents

Throws:

javax.jcr.RepositoryException - the repository exception

OutlookException - the outlook exception

nodeTitle

protected String nodeTitle(javax.jcr.Node node)
                    throws javax.jcr.RepositoryException

Node title.

Parameters:

node - the node

Returns:

the string

Throws:

javax.jcr.RepositoryException - the repository exception

nodeContent

protected javax.jcr.Node nodeContent(javax.jcr.Node node)
                              throws javax.jcr.RepositoryException

Node content.

Parameters:

node - the node

Returns:

the node

Throws:

javax.jcr.RepositoryException - the repository exception

nodeCreated

protected Calendar nodeCreated(javax.jcr.Node node)
                        throws javax.jcr.RepositoryException

Node created.

Parameters:

node - the node

Returns:

the calendar

Throws:

javax.jcr.RepositoryException - the repository exception

mimeType

protected String mimeType(javax.jcr.Node content)
                   throws javax.jcr.RepositoryException

Mime type.

Parameters:

content - the content

Returns:

the string

Throws:

javax.jcr.RepositoryException - the repository exception

data

protected javax.jcr.Property data(javax.jcr.Node content)
                           throws javax.jcr.RepositoryException

Data.

Parameters:

content - the content

Returns:

the property

Throws:

javax.jcr.RepositoryException - the repository exception

generateId

protected UUID generateId(String workspace,
                          String path)

Generate id.

Parameters:

workspace - the workspace

path - the path

Returns:

the uuid

getExoUser

protected org.exoplatform.services.organization.User getExoUser(String userName)
                                                         throws OutlookException

Gets the exo user.

Parameters:

userName - the user name

Returns:

the exo user

Throws:

OutlookException - the outlook exception

node

protected javax.jcr.Node node(String nodePath)
                       throws BadParameterException,
                              javax.jcr.RepositoryException

Node.

Parameters:

nodePath - the node path

Returns:

the node

Throws:

BadParameterException - the bad parameter exception

javax.jcr.RepositoryException - the repository exception

node

protected javax.jcr.Node node(String workspace,
                              String path)
                       throws BadParameterException,
                              javax.jcr.RepositoryException

Node.

Parameters:

workspace - the workspace

path - the path

Returns:

the node

Throws:

BadParameterException - the bad parameter exception

javax.jcr.RepositoryException - the repository exception

systemNode

protected javax.jcr.Node systemNode(String workspace,
                                    String path)
                             throws BadParameterException,
                                    javax.jcr.RepositoryException

System node.

Parameters:

workspace - the workspace

path - the path

Returns:

the node

Throws:

BadParameterException - the bad parameter exception

javax.jcr.RepositoryException - the repository exception

checkout

protected boolean checkout(javax.jcr.Node node)
                    throws javax.jcr.RepositoryException

Checkout.

Parameters:

node - the node

Returns:

true, if successful

Throws:

javax.jcr.RepositoryException - the repository exception

isNull

protected boolean isNull(org.exoplatform.ws.frameworks.json.value.JsonValue json)

Checks if is null.

Parameters:

json - the json

Returns:

true, if is null

isNotNull

protected boolean isNotNull(org.exoplatform.ws.frameworks.json.value.JsonValue json)

Checks if is not null.

Parameters:

json - the json

Returns:

true, if is not null

currentUserLocale

protected Locale currentUserLocale()

Current user locale.

Returns:

the locale

addFile

protected javax.jcr.Node addFile(javax.jcr.Node parent,
                                 String title,
                                 String contentType,
                                 InputStream content)
                          throws javax.jcr.RepositoryException

Add nt:file node for given content stream and title. If a node with such name exists a new name will be generated by adding a numerical index to the end.

Parameters:

parent - Node

title - String

contentType - String

content - InputStream

Returns:

Node

Throws:

javax.jcr.RepositoryException - when storage error

addFolder

protected javax.jcr.Node addFolder(javax.jcr.Node parent,
                                   String title,
                                   boolean forceNew)
                            throws javax.jcr.RepositoryException

Add nt:folder node with given title. If a node with such name exists and forceNew is true a new name will be generated by adding a numerical index to the end, otherwise existing node will be returned.

Parameters:

parent - Node

title - String

forceNew - if true then a new folder will be created with index in suffix, if false then existing folder will be returned

Returns:

Node

Throws:

javax.jcr.RepositoryException - when storage error

currentUserId

protected String currentUserId()

Current user id.

Returns:

the string

spaceService

protected org.exoplatform.social.core.space.spi.SpaceService spaceService()

Space service.

Returns:

the space service

socialIdentityManager

protected org.exoplatform.social.core.manager.IdentityManager socialIdentityManager()

Social identity manager.

Returns:

the identity manager

socialActivityManager

protected org.exoplatform.social.core.manager.ActivityManager socialActivityManager()

Social activity manager.

Returns:

the activity manager

socialRelationshipManager

protected org.exoplatform.social.core.manager.RelationshipManager socialRelationshipManager()

Social relationship manager.

Returns:

the relationship manager

userSpaces

protected List<OutlookSpace> userSpaces(String userId)
                                 throws OutlookSpaceException

User spaces.

Parameters:

userId - the user id

Returns:

the list

Throws:

OutlookSpaceException - the outlook space exception

checkRootFolderExistence

protected boolean checkRootFolderExistence(org.exoplatform.social.core.space.model.Space socialSpace)
                                    throws javax.jcr.RepositoryException,
                                           BadParameterException

Checks the root folder existence.

Parameters:

socialSpace - the social space

Returns:

the boolean - 'true' if the root folder exists

Throws:

javax.jcr.RepositoryException

BadParameterException

groupDocsPath

protected String groupDocsPath(String groupId)

Generate the group documents (as /Groups/spaces/$SPACE_GROUP_ID/Documents).

Parameters:

groupId - String

Returns:

String

userDocsPath

protected String userDocsPath(String userId)

Generate the user documents (as /Users/${userId}/Private/Documents).

Parameters:

userId - String

Returns:

String

groupPath

protected String groupPath(String groupId)
                    throws Exception

Generate the group node path (as /Groups/spaces/$SPACE_GROUP_ID).

Parameters:

groupId - String

Returns:

String

Throws:

Exception - when error

initWebDAVLink

protected void initWebDAVLink(HierarchyNode node)
                       throws OutlookException

Inits the web DAV link.

Parameters:

node - the node

Throws:

OutlookException - the outlook exception

initDocumentLink

protected void initDocumentLink(org.exoplatform.portal.mop.SiteType siteType,
                                String driveName,
                                String portalName,
                                String nodeURI,
                                HierarchyNode node)
                         throws OutlookException

Inits the document link.

Parameters:

siteType - the site type

driveName - the drive name

portalName - the portal name

nodeURI - the node URI

node - the node

Throws:

OutlookException - the outlook exception

initDocumentLink

protected void initDocumentLink(OutlookSpace space,
                                HierarchyNode file)
                         throws OutlookException

Inits the document link.

Parameters:

space - the space

file - the file

Throws:

OutlookException - the outlook exception

initDocumentLink

protected void initDocumentLink(OutlookServiceImpl.PersonalDocuments personalDocuments,
                                HierarchyNode file)
                         throws OutlookException

Inits the document link.

Parameters:

personalDocuments - the personal documents

file - the file

Throws:

OutlookException - the outlook exception

userDocumentsNode

protected javax.jcr.Node userDocumentsNode(String userName)
                                    throws Exception

Find given user Personal Documents folder using user session.

Parameters:

userName - String

Returns:

Node Personal Documents folder node or null

Throws:

Exception - when error

spaceDocumentsNode

protected javax.jcr.Node spaceDocumentsNode(String groupId)
                                     throws Exception

Find given group Documents folder using current user session.

Parameters:

groupId - String

Returns:

Node space's Documents folder node or null

Throws:

Exception - when error

setPermissions

protected void setPermissions(javax.jcr.Node node,
                              String... identities)
                       throws AccessControlException,
                              javax.jcr.RepositoryException

Set read permissions on the target node to all given identities (e.g. space group members). If node not yet exo:privilegeable it will add such mixin to allow set the permissions first. Requested permissions will not be set to the children nodes.

Parameters:

node - Node link target node

identities - array of String with user identifiers (names or memberships)

Throws:

AccessControlException - when access error

javax.jcr.RepositoryException - when storage error

setPermissions

protected void setPermissions(javax.jcr.Node node,
                              boolean deep,
                              boolean forcePrivilegeable,
                              String... identities)
                       throws AccessControlException,
                              javax.jcr.RepositoryException

Set read permissions on the target node to all given identities (e.g. space group members). Permissions will not be set if target not exo:privilegeable and forcePrivilegeable is false. If deep is true the target children nodes will be checked also for a need to set the requested permissions.

Parameters:

node - Node link target node

deep - Boolean if true then also children nodes will be set to the requested permissions

forcePrivilegeable - Boolean if true and node not yet exo:privilegeable it will add such mixin to allow set the permissions.

identities - array of String with user identifiers (names or memberships)

Throws:

AccessControlException - when access error

javax.jcr.RepositoryException - when storage error

messagesFolder

protected javax.jcr.Node messagesFolder(javax.jcr.Node parent,
                                        String... identity)
                                 throws javax.jcr.RepositoryException

Messages folder.

Parameters:

parent - the parent

identity - the identity

Returns:

the node

Throws:

javax.jcr.RepositoryException - the repository exception

addMessageFile

protected javax.jcr.Node addMessageFile(javax.jcr.Node parent,
                                        OutlookMessage message)
                                 throws javax.jcr.RepositoryException,
                                        UnsupportedEncodingException,
                                        IOException

Adds the message file.

Parameters:

parent - the parent

message - the message

Returns:

the node

Throws:

javax.jcr.RepositoryException - the repository exception

UnsupportedEncodingException - the unsupported encoding exception

IOException - Signals that an I/O exception has occurred.

postAttachmentActivity

protected org.exoplatform.social.core.activity.model.ExoSocialActivity postAttachmentActivity(Folder destFolder,
                                                                                              List<File> files,
                                                                                              OutlookUser user,
                                                                                              String comment)
                                                                                       throws javax.jcr.RepositoryException

Post attachment activity.

Parameters:

destFolder - the dest folder

files - the files

user - the user

comment - the comment

Returns:

the exo social activity

Throws:

javax.jcr.RepositoryException - the repository exception

readEmail

protected OutlookEmail readEmail(org.exoplatform.ws.frameworks.json.value.JsonValue vElem)
                          throws OutlookException

Read email.

Parameters:

vElem - the v elem

Returns:

the outlook email

Throws:

OutlookException - the outlook exception

fetchQuery

protected void fetchQuery(javax.jcr.query.QueryResult qr,
                          int limit,
                          Set<File> res)
                   throws javax.jcr.RepositoryException,
                          OutlookException

Fetch query.

Parameters:

qr - the qr

limit - the limit

res - the res

Throws:

javax.jcr.RepositoryException - the repository exception

OutlookException - the outlook exception

fetchQuery

protected void fetchQuery(javax.jcr.query.QueryResult qr,
                          int limit,
                          Set<File> res,
                          Predicate<javax.jcr.Node> acceptNode)
                   throws javax.jcr.RepositoryException,
                          OutlookException

Fetch query.

Parameters:

qr - the qr

limit - the limit

res - the res

acceptNode - the accept node

Throws:

javax.jcr.RepositoryException - the repository exception

OutlookException - the outlook exception

messageSummary

protected String messageSummary(OutlookMessage message)

Generate message summary text.

Parameters:

message - String

Returns:

String

isHTML

protected boolean isHTML(String content)

Try detect is it a HTML content in the string.

Parameters:

content - String

Returns:

boolean

safeHtml

protected String safeHtml(String content)

Allow full rage of HTML text and structures.

Parameters:

content - String

Returns:

String sanitized content

safeText

protected String safeText(String content)

Allow only plain text.

Parameters:

content - String

Returns:

String sanitized content (as plain text)

safeActivityMessage

protected String safeActivityMessage(String text)

Allow only activity tags as described in https://www.exoplatform.com/docs/PLF43/PLFUserGuide.GettingStarted.ActivitiesInActivityStream.HTMLTags. html.

Parameters:

text - String

Returns:

String allowed content

makeLinksOpenNewWindow

protected String makeLinksOpenNewWindow(String text)

Make links open new window.

Parameters:

text - the text

Returns:

the string

cleanName

public static String cleanName(String name)

Make JCR compatible item name.

Parameters:

name - String

Returns:

String JCR compatible name of local file