org.exoplatform.onlyoffice.rest

Class EditorService

java.lang.Object

org.exoplatform.onlyoffice.rest.EditorService

All Implemented Interfaces:

org.exoplatform.services.rest.resource.ResourceContainer

public class EditorService
extends Object
implements org.exoplatform.services.rest.resource.ResourceContainer

REST service implementing Onlyoffice config storage service.
Created by The eXo Platform SAS.

Version:

$Id: EditorService.java 00000 Feb 12, 2016 pnedonosko $

Author:

Peter Nedonosko

Field Summary

Fields

Modifier and Type	Field and Description
protected OnlyofficeEditorService	editors The editors.
protected Map<UUID,Config>	initiated The initiated.
protected static org.exoplatform.services.log.Log	LOG The Constant LOG.

Constructor Summary

Constructors

Constructor and Description
EditorService(OnlyofficeEditorService editors) REST cloudDrives uses OnlyofficeEditorService for actual job.

Method Summary

Modifier and Type	Method and Description
javax.ws.rs.core.Response	config(javax.ws.rs.core.UriInfo uriInfo, javax.servlet.http.HttpServletRequest request, String workspace, String path) Config configuration for Onlyoffice JS.
javax.ws.rs.core.Response	content(javax.ws.rs.core.UriInfo uriInfo, javax.servlet.http.HttpServletRequest request, String userId, String key) Document content download link.
protected String	getClientHost(javax.servlet.http.HttpServletRequest request) Gets the client host.
protected String	getClientIpAddr(javax.servlet.http.HttpServletRequest request) Gets the client ip addr.
protected boolean	isValidHost(String host) Checks if is valid host.
javax.ws.rs.core.Response	localState(javax.ws.rs.core.UriInfo uriInfo, String userId, String key) Editing document state in local storage.
protected boolean	notEmpty(String str) Check string is not empty.
protected String	requestHost(URI requestUri) Request host.
javax.ws.rs.core.Response	status(javax.ws.rs.core.UriInfo uriInfo, javax.servlet.http.HttpServletRequest request, String userId, String key, String statusText) Config status posted from the Document Server.

Methods inherited from class java.lang.Object

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

Field Detail

LOG

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

The Constant LOG.

editors

protected final OnlyofficeEditorService editors

The editors.

initiated

protected final Map<UUID,Config> initiated

The initiated.

Constructor Detail

EditorService

public EditorService(OnlyofficeEditorService editors)

REST cloudDrives uses OnlyofficeEditorService for actual job.

Parameters:

editors - the editors

Method Detail

status

public javax.ws.rs.core.Response status(@Context
                                        javax.ws.rs.core.UriInfo uriInfo,
                                        @Context
                                        javax.servlet.http.HttpServletRequest request,
                                        String userId,
                                        String key,
                                        String statusText)

Config status posted from the Document Server.
WARNING! It is publicly accessible service but access from the Documents Server host can be restricted (by default).

Parameters:

uriInfo - - request info

request - the request

userId - the user id

key - - config key generated when requested editor config

statusText - the status text

Returns:

Response

content

public javax.ws.rs.core.Response content(@Context
                                         javax.ws.rs.core.UriInfo uriInfo,
                                         @Context
                                         javax.servlet.http.HttpServletRequest request,
                                         String userId,
                                         String key)

Document content download link.
WARNING! It is publicly accessible service but access from the Documents Server host can be restricted (by default).

Parameters:

uriInfo - - request info

request - the request

userId - the user id

key - - file key generated by /config method

Returns:

Response

config

@RolesAllowed(value="users")
public javax.ws.rs.core.Response config(@Context
                                                                     javax.ws.rs.core.UriInfo uriInfo,
                                                                     @Context
                                                                     javax.servlet.http.HttpServletRequest request,
                                                                     String workspace,
                                                                     String path)

Config configuration for Onlyoffice JS.

Parameters:

uriInfo - - request with base URI

request - the request

workspace - the workspace

path - the path

Returns:

response with

localState

@RolesAllowed(value="users")
public javax.ws.rs.core.Response localState(@Context
                                                                         javax.ws.rs.core.UriInfo uriInfo,
                                                                         String userId,
                                                                         String key)

Editing document state in local storage.

Parameters:

uriInfo - - request info

userId - the user id

key - - config key generated when requested editor config

Returns:

Response

getClientIpAddr

protected String getClientIpAddr(javax.servlet.http.HttpServletRequest request)

Gets the client ip addr.

Parameters:

request - the request

Returns:

the client ip addr

getClientHost

protected String getClientHost(javax.servlet.http.HttpServletRequest request)

Gets the client host.

Parameters:

request - the request

Returns:

the client host

notEmpty

protected boolean notEmpty(String str)

Check string is not empty.

Parameters:

str - the str

Returns:

true, if not empty, false otherwise

isValidHost

protected boolean isValidHost(String host)

Checks if is valid host. It's a trivial check for null, non empty string and not "unknown" text.

Parameters:

host - the host name or IP address

Returns:

true, if is valid host

requestHost

protected String requestHost(URI requestUri)

Request host.

Parameters:

requestUri - the request uri

Returns:

the string