Squidex
  • Welcome to Squidex
  • Getting Started
    • Squidex Cloud
    • Installation Instructions
      • Platforms
        • Install on Kubernetes
        • Install on AWS (Deprecated)
        • Install on AWS EC2 using Docker
        • Install on Azure
        • Install on Azure using ARM
        • Install on Google Cloud Platform (GCP)
        • Install on Docker
        • Install on Heroku
        • Install on IIS
        • Install on Render
        • Install on Vultr
      • Configuration
        • Deploying the Image Resizer Service
      • Troubleshooting and Support
        • Diagnose Runtime Issues
        • Restoring Deleted Apps
      • Install Identity (Deprecated)
      • External Identity Providers
        • Azure AD (OAuth) with Squidex
    • Contributing and Developing
      • Building
      • Developing
      • Extensions
        • Custom Rule Action
      • Contributing
      • Architecture
      • Translating
      • Squidex Docs Program
    • Roadmap
    • Quick Start Guides
      • Vue.js Blog with Squidex
      • React.js Blog with Squidex
      • Angular Blog with Squidex
  • Documentation
    • Introduction and Use Case
    • Concepts
      • Apps
      • Teams
      • Schemas
        • Field Rules
      • Content
        • Scheduled Publishing
      • Assets
        • Querying Assets
      • Localization
      • Migrations
      • Roles & Permissions
      • Rules
        • Publish an Event to Azure Queues using Rules
        • Populate Elasticsearch Index
      • Backups
      • Subscriptions
        • App Subscriptions v/s Team Subscriptions
      • Notifications
      • Dashboard
      • Workflows
    • Software Development Kits
      • TypeScript
      • .NET
        • Version v14 (and Earlier)
        • Version v15 (and Later)
      • PHP
      • Java
    • Developer Guides
      • API
        • Authentication
        • Postman
        • Queries
        • Assets
      • Automation Tools (CLI)
      • Scripting
        • Scripting Helper Methods
      • Embed Content
      • Custom Workflows
      • Custom Editors
      • Custom Sidebars
      • Preview Content
      • Rule Formatting
        • Simple
        • Script
        • Liquid
      • Tutorials
        • Building a Blog with Squidex and Next.js
  • Next
    • Squidex 3.0: API Compatibility
Powered by GitBook
On this page
  • Introduction
  • Install the SDK
  • Maven
  • Maven
  • Instantiate the SDK
  • Additional Configuration
  • Use the Client
  • Error Handling
  • Limitations

Was this helpful?

  1. Documentation
  2. Software Development Kits

Java

Easy installation and setup of the Java SDK.

PreviousPHPNextDeveloper Guides

Last updated 1 year ago

Was this helpful?

Introduction

The SDK is mostly generated from the OpenAPI specification. You can read the API documentation here:.

This means that the API is fully covered, including all endpoints used by the frontend. You can also use the SDK to create and configure Apps, schemas and rules.

Use this SDK in your Java application to integrate with Squidex CMS.

Install the SDK

The SDK is available on . The installation depends on your build system.

Maven

Add the dependency in your build.gradle:

dependencies {
    implementation 'io.squidex:squidex:1.0.0'
}

Maven

Add the dependency in your pom.xml:

<dependency>
    <groupId>io.squidex</groupId>
    <artifactId>squidex</artifactId>
    <version>1.0.0</version>
</dependency>// Some code

Instantiate the SDK

The SquidexClient is the main entry point for the SDK. It provides the properties for all endpoints.

You can instantiate the client using the following code snippet:

SquidexClient squidex = SquidexClient.builder()
    .appName("my-app")
    .clientId("your-app:default")
    .clientSecret("xxx")
    .url("https://your.squidex-deployment")
    .build();

The url parameter is optional if you are using Squidex Cloud.

Additional Configuration

Timeout

Configure a timeout in seconds to cancel unresponsive requests.

OkHttpClient client = new OkHttpClient.Builder()
    .connectTimeout(10, TimeUnit.SECONDS)
    .writeTimeout(10, TimeUnit.SECONDS)
    .readTimeout(30, TimeUnit.SECONDS)
    .build();
        
SquidexClient squidex = SquidexClient.builder()
    ...
    .httpClient(client)
    .build();

The default timeout is 30 seconds.

Token Store

The SDK uses the client ID and the client secret to acquire a bearer token, and handles invalidation and expiration automatically. By default the token is stored inside the client and therefore a new token is acquired when the client is cleaned by the garbage collector. However, one can define where the token is stored.

SquidexClient squidex = SquidexClient.builder()
    ...
    .tokenStore(new MyTokenStore())
    .build();

Ignore Certificates

By default the certificates are validated. But for test environments it might be necessary to connect to instances with self signed certificates only. Therefore we have introduced an option to ignore the certificate chain:

SquidexClient squidex = SquidexClient.builder()
    ...
    .trustAllCerts()
    .build();

Use the Client

To use the client you have to use the correct property.

For example, to create a schema use the schemas property.

CreateSchemaDto request = CreateSchemaDto.builder()
    .name("my-schema")
    .fields(Collections.singletonList(
        UpsertSchemaFieldDto.builder()
            .name("field1")
            .properties(
                FieldPropertiesDto.string(
                    StringFieldPropertiesDto.builder()
                    .build()))
                .build()))
    .isPublished(true)
    .build();

SchemaDto createdSchema = client.schemas().postSchema(request);

In order to work with contents, use the contents property.

Map<String, Map<String, Object>> dataItem = new HashMap<>();
Map<String, Object> dataField = new HashMap<>();
dataItem.put("field1", dataField);
dataField.put("iv", id);

ContentsPostContentRequest request = ContentsPostContentRequest.builder()
    .body(dataItem)
    .publish(true)
    .build();
    
client.contents().postContent(schema.getName(), request);

Error Handling

The SDK uses exceptions for error handling.

Refer to the code snippet below for an example:

try {
    client.client().apps().postApp(
        CreateAppDto.builder()
            .name("my-app")
            .build());
} catch (ApiError ex) {
    if (ex.statusCode() == 400) {
        System.out.println("App probably already exists.");
        return;
    } else {
        throw ex;
    }
}

Limitations

As of this writing, the SDK has the following limitations:

  1. Endpoints to download files (e.g. assets) return a stream only and not metadata information like the content type or the content length.

  2. Endpoints to download files work for Node only and are not available in the browser. This is generally not an issue as assets are handled via direct links in the browser.

  3. The generated builders all follow the staged builder pattern. For untyped data, e.g. content items the builder is not available yet and you have to construct the data structure manually using hash maps and arrays.

  4. Deprecated methods and properties are not annotated yet.

In this article, we will cover some of the important configuration values only. The client is based on the library to support all platforms including Android. Therefore many configuration options are available throug passing a custom client to Squidex. This client gets cloned to make customizations, for example for authentication.

Read more:

https://cloud.squidex.io/api/docs
Maven
OkHttp
https://square.github.io/okhttp/recipes/#timeouts-kt-java