Skip to content

SDK for integrating ONLYOFFICE Document Server into your own website or application on Java

License

Notifications You must be signed in to change notification settings

aleksandrfedorov97/docs-integration-sdk-java

 
 

Repository files navigation

ONLYOFFICE Docs Integration SDK

ONLYOFFICE Docs Integration SDK provides common interfaces and default implementations for integrating ONLYOFFICE Document Server into your own website or application on Java.

Prerequisites

SDK structure

SDK consists of 5 main managers and 4 services.

Managers

Manager Description Default implementation
DocumentManager This manager is used for working with files and document formats. DefaultDocumentManager (abstract)
RequestManager This manager is used to make requests to the ONLYOFFICE Document Server. DefaultRequestManager
JwtManager This manager is used for generating and verifying authorization tokens. DefaultJwtManager
SettingsManager This manager is used to manage integration application settings. DefaultSettingsManager (abstract)
UrlManager This manager is used as a URL provider. DefaultUrlManager

Services

Service Description Default implementation
ConfigService This configuration generation service is used for opening the document editor. DefaultConfigService
CallbackService This service is used for processing the response of the document server. DefaultCallbackService
ConvertService This service is used for converting documents. DefaultConvertService
SettingsValidationService This service is used for checking document server connection settings. DefaultSettingsValidationService

Usage

Let's look at the demo example, which shows how the SDK works in a classic Spring web application:

  1. Implement the methods of the abstract DefaultSettingsManager class:
@Override
public String getSetting(final String name) {
    return properties.getProperty(name);
}

@Override
public void setSetting(final String name, final String value) {
    properties.setProperty(name, value);
}

The full example code can be found here.

  1. Implement the methods of the abstract DefaultDocumentManager class:
@Override
public String getDocumentKey(final  String fileId, final boolean embedded) {
    return String.valueOf(fileId.hashCode());
}

@Override
public String getDocumentName(final String fileId) {
    return "sample.docx";
}

The full example code can be found here.

  1. Implement the UrlManager methods. To open the editor in the editing mode, you need to define:
@Override
public String getFileUrl(final String fileId) {
    return getServerUrl() + "/file/download";
}

@Override
public String getCallbackUrl(final String fileId) {
    return getServerUrl() + "/callback";
}

The full example code can be found here.

  1. Initialize the JwtManager and RequestManager Spring beans and add them to the DI container. This allows you to call the registered beans anywhere in the application:
@Bean
public JwtManager jwtManager(final SettingsManager settingsManager) {
    return new DefaultJwtManager(settingsManager);
}

@Bean
public RequestManager requestManager(final UrlManager urlManager, final JwtManager jwtManager, final SettingsManager settingsManager) {
    return new DefaultRequestManager(urlManager, jwtManager, settingsManager);
}

The full example code can be found here.

  1. After this, you can use all available services in their default implementations or by overriding and extending them:
  • To use the callback service, create the callback controller where the request body is wrapped in the Callback model and the callback service is called to handle this model.
  • To demonstrate the config service work, @GetMapping("/editor") is used in the main controller. When the user opens this address, the editor page is requested. At the same time, the config service is called and generates the Config model to open the editor:
@GetMapping("/editor")
public String main(final Model model) throws JsonProcessingException {

    Config config = configService.createConfig("1", Mode.EDIT, Type.DESKTOP);

    model.addAttribute("config", config);
    model.addAttribute("documentServerApiUrl", urlManager.getDocumentServerApiUrl());

    return "editor";
}
  1. Create the file controller to get a file for opening in the editor. When the config service generates the config model, the URL for downloading a file is specified in this model. To open the document, the editor sends a request to this URL, and the file controller responds to this request and returns the document.

About

SDK for integrating ONLYOFFICE Document Server into your own website or application on Java

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Java 99.6%
  • HTML 0.4%