org.exoplatform.clouddrive.box

Class JCRLocalBoxDrive

java.lang.Object

org.exoplatform.clouddrive.CloudDrive

org.exoplatform.clouddrive.jcr.JCRLocalCloudDrive

org.exoplatform.clouddrive.box.JCRLocalBoxDrive

All Implemented Interfaces:

org.exoplatform.clouddrive.CloudDriveSecurity, org.exoplatform.clouddrive.CloudDriveStorage, org.exoplatform.clouddrive.oauth2.UserTokenRefreshListener

public class JCRLocalBoxDrive
extends org.exoplatform.clouddrive.jcr.JCRLocalCloudDrive
implements org.exoplatform.clouddrive.oauth2.UserTokenRefreshListener

Local drive for Box. Created by The eXo Platform SAS.

Version:

$Id: JCRLocalBoxDrive.java 00000 Aug 30, 2013 pnedonosko $

Author:

Peter Nedonosko

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	JCRLocalBoxDrive.BoxState
protected class	JCRLocalBoxDrive.Connect Connect algorithm for Box drive.
protected class	JCRLocalBoxDrive.EventsSync Sync algorithm for Box drive based on drive changes obtained from Events service http://developers.box.com/docs/#events.
protected class	JCRLocalBoxDrive.FileAPI
protected class	JCRLocalBoxDrive.FullSync Sync algorithm for Box drive based on all remote files traversing: we do compare all remote files with locals by its Etag and fetch an item if the tags differ.

Nested classes/interfaces inherited from class org.exoplatform.clouddrive.jcr.JCRLocalCloudDrive

org.exoplatform.clouddrive.jcr.JCRLocalCloudDrive.AbstractCommand, org.exoplatform.clouddrive.jcr.JCRLocalCloudDrive.AbstractFileAPI, org.exoplatform.clouddrive.jcr.JCRLocalCloudDrive.CommandCallable, org.exoplatform.clouddrive.jcr.JCRLocalCloudDrive.ConnectCommand, org.exoplatform.clouddrive.jcr.JCRLocalCloudDrive.DriveState, org.exoplatform.clouddrive.jcr.JCRLocalCloudDrive.ExoJCREnvironment, org.exoplatform.clouddrive.jcr.JCRLocalCloudDrive.ExoJCRSettings, org.exoplatform.clouddrive.jcr.JCRLocalCloudDrive.FileChange, org.exoplatform.clouddrive.jcr.JCRLocalCloudDrive.JCRListener, org.exoplatform.clouddrive.jcr.JCRLocalCloudDrive.NoConnectCommand, org.exoplatform.clouddrive.jcr.JCRLocalCloudDrive.NoSyncCommand, org.exoplatform.clouddrive.jcr.JCRLocalCloudDrive.SyncCommand, org.exoplatform.clouddrive.jcr.JCRLocalCloudDrive.SyncFilesCommand

Nested classes/interfaces inherited from class org.exoplatform.clouddrive.CloudDrive

org.exoplatform.clouddrive.CloudDrive.Command, org.exoplatform.clouddrive.CloudDrive.CommandProgress, org.exoplatform.clouddrive.CloudDrive.FilesState, org.exoplatform.clouddrive.CloudDrive.ListenerSupport

Nested classes/interfaces inherited from interface org.exoplatform.clouddrive.CloudDriveStorage

org.exoplatform.clouddrive.CloudDriveStorage.Change<R>

Field Summary

Fields

Modifier and Type	Field and Description
static long	FULL_SYNC_PERIOD Period to perform JCRLocalBoxDrive.FullSync as a next sync request.

Fields inherited from class org.exoplatform.clouddrive.jcr.JCRLocalCloudDrive

accentsConverter, actionDrive, ALREADY_DONE, commandEnv, CURRENT_LOCALFORMAT, currentChangeId, currentConnect, currentSync, driveCommands, DUMMY_DATA, ECD_CLOUDDRIVE, ECD_CLOUDFILE, ECD_CLOUDFILERESOURCE, ECD_CLOUDFOLDER, ECD_IGNORED, ECD_LOCALFORMAT, EXO_DATETIME, EXO_MODIFY, EXO_THUMBNAIL, EXO_THUMBNAILS, EXO_TRASHFOLDER, fileAPI, fileChanges, fileChangeSequencer, fileCopies, fileHistory, fileRemovals, fileSynchronizers, fileTrash, finder, HISTORY_EXPIRATION, HISTORY_MAX_LENGTH, jcrListener, mimeTypes, MIX_REFERENCEABLE, noConnect, noSync, NT_FILE, NT_FOLDER, NT_RESOURCE, NT_UNSTRUCTURED, repository, rootNodeHolder, rootUUID, rootWorkspace, sessionProviders, state, syncFilesChanged, syncFilesMessages, syncLock, updating, user, USER_NODEPATH, USER_SESSIONPROVIDER, USER_WORKSPACE, workerExecutor

Fields inherited from class org.exoplatform.clouddrive.CloudDrive

listeners, LOG

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	JCRLocalBoxDrive(org.exoplatform.clouddrive.box.BoxConnector.API apiBuilder, BoxProvider provider, javax.jcr.Node driveNode, org.exoplatform.services.jcr.ext.app.SessionProviderService sessionProviders, org.exoplatform.clouddrive.jcr.NodeFinder finder, org.exoplatform.clouddrive.utils.ExtendedMimeTypeResolver mimeTypes)
protected	JCRLocalBoxDrive(BoxUser user, javax.jcr.Node driveNode, org.exoplatform.services.jcr.ext.app.SessionProviderService sessionProviders, org.exoplatform.clouddrive.jcr.NodeFinder finder, org.exoplatform.clouddrive.utils.ExtendedMimeTypeResolver mimeTypes)

Method Summary

Methods

Modifier and Type	Method and Description
protected org.exoplatform.clouddrive.CloudFileAPI	createFileAPI()
protected String	findMimetype(String fileName)
protected org.exoplatform.clouddrive.jcr.JCRLocalCloudDrive.ConnectCommand	getConnectCommand()
protected Long	getSequenceId(com.box.sdk.BoxItem.Info item)
JCRLocalBoxDrive.BoxState	getState()
protected org.exoplatform.clouddrive.jcr.JCRLocalCloudDrive.SyncCommand	getSyncCommand()
BoxUser	getUser()
protected boolean	initBoxItem(javax.jcr.Node localNode, com.box.sdk.BoxItem.Info item) Initialize Box's common specifics of files and folders.
protected void	initDrive(javax.jcr.Node driveNode)
protected static BoxUser	loadUser(org.exoplatform.clouddrive.box.BoxConnector.API apiBuilder, BoxProvider provider, javax.jcr.Node driveNode) Load user from the drive Node.
protected boolean	notInRange(String path, Collection<String> range)
void	onUserTokenRefresh(org.exoplatform.clouddrive.oauth2.UserToken token)
protected String	previewLink(javax.jcr.Node fileNode)
protected Long	readChangeId()
protected void	refreshAccess()
protected void	saveChangeId(Long id)
protected void	updateAccess(org.exoplatform.clouddrive.CloudUser newUser)
protected org.exoplatform.clouddrive.jcr.JCRLocalCloudFile	updateItem(BoxAPI api, com.box.sdk.BoxItem.Info item, javax.jcr.Node parent, javax.jcr.Node node) Update or create a local node of Cloud File.

Methods inherited from class org.exoplatform.clouddrive.jcr.JCRLocalCloudDrive

addJCRListener, addUpdating, await, checkNotTrashed, cleanName, cleanRemoved, cleanup, cleanUpdated, commitChanges, configure, connect, copyNode, create, currentUserName, disconnect, editLink, ensureSame, fileNode, findNode, findNodes, getChangeId, getConnectDate, getCurentCommand, getFile, getFileContent, getFilePreview, getId, getInitDate, getLink, getLocalUser, getOrCleanFileNode, getPath, getTitle, hasFile, hasRemoved, hasUpdated, ignore, initCommon, initCopy, initFile, initFolder, initRemove, initUpdating, isConnected, isDrive, isDrive, isIgnored, isInDrive, isInTrash, isLocal, isNew, isNewOrUpdating, isSameDrive, isSharingSupported, isUpdating, link, listFiles, listFiles, listFiles, loadHistory, localChange, migrateName, moveFile, nextChangeId, nodeName, openFile, openFolder, readFile, readNode, readNodes, removeJCRListener, removeUpdating, rollback, rollbackAllChanges, rollbackChanges, rootNode, rootNode, saveChanges, savedChanges, session, setChangeId, shareFile, size, synchronize, systemSession, thumbnailLink, title, unignore

Methods inherited from class org.exoplatform.clouddrive.CloudDrive

addListener, removeListener, toString

Methods inherited from class java.lang.Object

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

Field Detail

FULL_SYNC_PERIOD

public static final long FULL_SYNC_PERIOD

Period to perform JCRLocalBoxDrive.FullSync as a next sync request. See implementation of getSyncCommand().

See Also:

Constant Field Values

Constructor Detail

JCRLocalBoxDrive

protected JCRLocalBoxDrive(BoxUser user,
                javax.jcr.Node driveNode,
                org.exoplatform.services.jcr.ext.app.SessionProviderService sessionProviders,
                org.exoplatform.clouddrive.jcr.NodeFinder finder,
                org.exoplatform.clouddrive.utils.ExtendedMimeTypeResolver mimeTypes)
                    throws org.exoplatform.clouddrive.CloudDriveException,
                           javax.jcr.RepositoryException

Parameters:

user -

driveNode -

sessionProviders -

Throws:

org.exoplatform.clouddrive.CloudDriveException

javax.jcr.RepositoryException

JCRLocalBoxDrive

protected JCRLocalBoxDrive(org.exoplatform.clouddrive.box.BoxConnector.API apiBuilder,
                BoxProvider provider,
                javax.jcr.Node driveNode,
                org.exoplatform.services.jcr.ext.app.SessionProviderService sessionProviders,
                org.exoplatform.clouddrive.jcr.NodeFinder finder,
                org.exoplatform.clouddrive.utils.ExtendedMimeTypeResolver mimeTypes)
                    throws javax.jcr.RepositoryException,
                           org.exoplatform.clouddrive.CloudDriveException

Throws:

javax.jcr.RepositoryException

org.exoplatform.clouddrive.CloudDriveException

Method Detail

initDrive

protected void initDrive(javax.jcr.Node driveNode)
                  throws org.exoplatform.clouddrive.CloudDriveException,
                         javax.jcr.RepositoryException

Overrides:

initDrive in class org.exoplatform.clouddrive.jcr.JCRLocalCloudDrive

Throws:

org.exoplatform.clouddrive.CloudDriveException

javax.jcr.RepositoryException

loadUser

protected static BoxUser loadUser(org.exoplatform.clouddrive.box.BoxConnector.API apiBuilder,
               BoxProvider provider,
               javax.jcr.Node driveNode)
                           throws javax.jcr.RepositoryException,
                                  BoxException,
                                  org.exoplatform.clouddrive.CloudDriveException

Load user from the drive Node.

Parameters:

apiBuilder - BoxConnector.API API builder

provider - BoxProvider

driveNode - Node root of the drive

Returns:

BoxUser

Throws:

javax.jcr.RepositoryException

BoxException

org.exoplatform.clouddrive.CloudDriveException

onUserTokenRefresh

public void onUserTokenRefresh(org.exoplatform.clouddrive.oauth2.UserToken token)
                        throws org.exoplatform.clouddrive.CloudDriveException

Specified by:

onUserTokenRefresh in interface org.exoplatform.clouddrive.oauth2.UserTokenRefreshListener

Throws:

BoxException

org.exoplatform.clouddrive.CloudDriveException

getConnectCommand

protected org.exoplatform.clouddrive.jcr.JCRLocalCloudDrive.ConnectCommand getConnectCommand()
                                                                                      throws org.exoplatform.clouddrive.DriveRemovedException,
                                                                                             javax.jcr.RepositoryException

Specified by:

getConnectCommand in class org.exoplatform.clouddrive.jcr.JCRLocalCloudDrive

Throws:

org.exoplatform.clouddrive.DriveRemovedException

javax.jcr.RepositoryException

getSyncCommand

protected org.exoplatform.clouddrive.jcr.JCRLocalCloudDrive.SyncCommand getSyncCommand()
                                                                                throws org.exoplatform.clouddrive.DriveRemovedException,
                                                                                       org.exoplatform.clouddrive.SyncNotSupportedException,
                                                                                       javax.jcr.RepositoryException

Specified by:

getSyncCommand in class org.exoplatform.clouddrive.jcr.JCRLocalCloudDrive

Throws:

org.exoplatform.clouddrive.DriveRemovedException

org.exoplatform.clouddrive.SyncNotSupportedException

javax.jcr.RepositoryException

createFileAPI

protected org.exoplatform.clouddrive.CloudFileAPI createFileAPI()
                                                         throws org.exoplatform.clouddrive.DriveRemovedException,
                                                                org.exoplatform.clouddrive.SyncNotSupportedException,
                                                                javax.jcr.RepositoryException

Specified by:

createFileAPI in class org.exoplatform.clouddrive.jcr.JCRLocalCloudDrive

Throws:

org.exoplatform.clouddrive.DriveRemovedException

org.exoplatform.clouddrive.SyncNotSupportedException

javax.jcr.RepositoryException

readChangeId

protected Long readChangeId()
                     throws javax.jcr.RepositoryException,
                            org.exoplatform.clouddrive.CloudDriveException

Specified by:

readChangeId in class org.exoplatform.clouddrive.jcr.JCRLocalCloudDrive

Throws:

javax.jcr.RepositoryException

org.exoplatform.clouddrive.CloudDriveException

saveChangeId

protected void saveChangeId(Long id)
                     throws org.exoplatform.clouddrive.CloudDriveException,
                            javax.jcr.RepositoryException

Specified by:

saveChangeId in class org.exoplatform.clouddrive.jcr.JCRLocalCloudDrive

Throws:

org.exoplatform.clouddrive.CloudDriveException

javax.jcr.RepositoryException

getUser

public BoxUser getUser()

Specified by:

getUser in class org.exoplatform.clouddrive.CloudDrive

getState

public JCRLocalBoxDrive.BoxState getState()
                                   throws org.exoplatform.clouddrive.DriveRemovedException,
                                          org.exoplatform.clouddrive.CloudProviderException,
                                          javax.jcr.RepositoryException,
                                          org.exoplatform.clouddrive.RefreshAccessException

Overrides:

getState in class org.exoplatform.clouddrive.jcr.JCRLocalCloudDrive

Throws:

org.exoplatform.clouddrive.DriveRemovedException

org.exoplatform.clouddrive.CloudProviderException

javax.jcr.RepositoryException

org.exoplatform.clouddrive.RefreshAccessException

refreshAccess

protected void refreshAccess()
                      throws org.exoplatform.clouddrive.CloudDriveException

Specified by:

refreshAccess in class org.exoplatform.clouddrive.CloudDrive

Throws:

org.exoplatform.clouddrive.CloudDriveException

updateAccess

protected void updateAccess(org.exoplatform.clouddrive.CloudUser newUser)
                     throws org.exoplatform.clouddrive.CloudDriveException,
                            javax.jcr.RepositoryException

Specified by:

updateAccess in class org.exoplatform.clouddrive.CloudDrive

Throws:

org.exoplatform.clouddrive.CloudDriveException

javax.jcr.RepositoryException

initBoxItem

protected boolean initBoxItem(javax.jcr.Node localNode,
                  com.box.sdk.BoxItem.Info item)
                       throws javax.jcr.RepositoryException,
                              BoxException

Initialize Box's common specifics of files and folders.

Parameters:

localNode - Node

item - BoxItem.Info

Returns:

boolean true if Box file was changed comparing to previous state, false

Throws:

javax.jcr.RepositoryException

BoxException

findMimetype

protected String findMimetype(String fileName)

updateItem

protected org.exoplatform.clouddrive.jcr.JCRLocalCloudFile updateItem(BoxAPI api,
                                                          com.box.sdk.BoxItem.Info item,
                                                          javax.jcr.Node parent,
                                                          javax.jcr.Node node)
                                                               throws javax.jcr.RepositoryException,
                                                                      org.exoplatform.clouddrive.CloudDriveException

Update or create a local node of Cloud File. If the node is null then it will be open on the given parent and created if not already exists.

Parameters:

api - BoxAPI

item - BoxItem.Info

parent - Node

node - Node, can be null

Returns:

JCRLocalCloudFile

Throws:

javax.jcr.RepositoryException - for storage errors

org.exoplatform.clouddrive.CloudDriveException - for drive or format errors

notInRange

protected boolean notInRange(String path,
                 Collection<String> range)

getSequenceId

protected Long getSequenceId(com.box.sdk.BoxItem.Info item)
                      throws BoxFormatException

Throws:

BoxFormatException

previewLink

protected String previewLink(javax.jcr.Node fileNode)
                      throws javax.jcr.RepositoryException

Overrides:

previewLink in class org.exoplatform.clouddrive.jcr.JCRLocalCloudDrive

Throws:

javax.jcr.RepositoryException