com.files.models.Lock Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of files-sdk Show documentation
Show all versions of files-sdk Show documentation
The Files.com Java client library provides convenient access to the Files.com API from JVM based applications.
package com.files.models;
import com.fasterxml.jackson.annotation.JsonFormat;
import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
import com.fasterxml.jackson.annotation.JsonInclude;
import com.fasterxml.jackson.annotation.JsonProperty;
import com.fasterxml.jackson.core.JsonProcessingException;
import com.fasterxml.jackson.core.type.TypeReference;
import com.fasterxml.jackson.databind.MapperFeature;
import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.databind.ObjectReader;
import com.fasterxml.jackson.databind.SerializationFeature;
import com.fasterxml.jackson.databind.json.JsonMapper;
import com.files.FilesClient;
import com.files.FilesConfig;
import com.files.ListIterator;
import com.files.net.HttpMethods.RequestMethods;
import com.files.util.FilesInputStream;
import com.files.util.ModelUtils;
import java.io.BufferedInputStream;
import java.io.FileInputStream;
import java.io.FileOutputStream;
import java.io.IOException;
import java.io.InputStream;
import java.io.OutputStream;
import java.net.URI;
import java.net.URISyntaxException;
import java.text.SimpleDateFormat;
import java.util.Date;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
import lombok.Getter;
import lombok.Setter;
@JsonIgnoreProperties(ignoreUnknown = true)
@JsonInclude(JsonInclude.Include.NON_NULL)
public class Lock {
private HashMap options;
private ObjectMapper objectMapper = JsonMapper
.builder()
.disable(MapperFeature.CAN_OVERRIDE_ACCESS_MODIFIERS)
.disable(SerializationFeature.WRITE_DATES_AS_TIMESTAMPS)
.defaultDateFormat(new SimpleDateFormat("yyyy-MM-dd'T'HH:mm:ssX"))
.build();
public Lock() {
this(null, null);
}
public Lock(HashMap parameters) {
this(parameters, null);
}
public Lock(HashMap parameters, HashMap options) {
this.options = options;
try {
ObjectReader objectReader = objectMapper.readerForUpdating(this);
objectReader.readValue(objectMapper.writeValueAsString(parameters));
} catch (JsonProcessingException e) {
// TODO: error generation on constructor
}
}
/**
* Path This must be slash-delimited, but it must neither start nor end with a slash. Maximum of 5000 characters.
*/
@Getter
@Setter
@JsonProperty("path")
public String path;
/**
* Lock timeout in seconds
*/
@Getter
@Setter
@JsonProperty("timeout")
public Long timeout;
/**
* DEPRECATED: Lock depth
*/
@Getter
@Setter
@JsonProperty("depth")
public String depth;
/**
* Does lock apply to subfolders?
*/
@Getter
@Setter
@JsonProperty("recursive")
public Boolean recursive;
/**
* Owner of the lock. This can be any arbitrary string.
*/
@Getter
@Setter
@JsonProperty("owner")
public String owner;
/**
* DEPRECATED: Lock scope
*/
@Getter
@Setter
@JsonProperty("scope")
public String scope;
/**
* Is lock exclusive?
*/
@Getter
@Setter
@JsonProperty("exclusive")
public Boolean exclusive;
/**
* Lock token. Use to release lock.
*/
@Getter
@Setter
@JsonProperty("token")
public String token;
/**
* DEPRECATED: Lock type
*/
@Getter
@Setter
@JsonProperty("type")
public String type;
/**
* Can lock be modified by users other than its creator?
*/
@Getter
@Setter
@JsonProperty("allow_access_by_any_user")
public Boolean allowAccessByAnyUser;
/**
* Lock creator user ID
*/
@Getter
@Setter
@JsonProperty("user_id")
public Long userId;
/**
* Lock creator username
*/
@Getter
@Setter
@JsonProperty("username")
public String username;
/**
* Parameters:
* token (required) - string - Lock token
*/
public void delete(HashMap parameters) {
delete(parameters);
}
public void destroy(HashMap parameters) {
delete(parameters);
}
public void save() throws IOException {
HashMap parameters = ModelUtils.toParameterMap(objectMapper.writeValueAsString(this));
if (parameters.containsKey("id") && parameters.get("id") != null) {
throw new UnsupportedOperationException("The Lock Object doesn't support updates.");
} else {
Lock.create(parameters, this.options);
}
}
/**
* Parameters:
* cursor - string - Used for pagination. When a list request has more records available, cursors are provided in the response headers `X-Files-Cursor-Next` and `X-Files-Cursor-Prev`. Send one of those cursor value here to resume an existing list from the next available record. Note: many of our SDKs have iterator methods that will automatically handle cursor-based pagination.
* per_page - int64 - Number of records to show per page. (Max: 10,000, 1,000 or less is recommended).
* path (required) - string - Path to operate on.
* include_children - boolean - Include locks from children objects?
*/
public static ListIterator listFor() throws RuntimeException {
return listFor(null, null, null);
}
public static ListIterator listFor(String path, HashMap parameters) throws RuntimeException {
return listFor(path, parameters, null);
}
public static ListIterator listFor(HashMap parameters, HashMap options) throws RuntimeException {
return listFor(null, parameters, options);
}
public static ListIterator listFor(String path, HashMap parameters, HashMap options) throws RuntimeException {
parameters = parameters != null ? parameters : new HashMap();
options = options != null ? options : new HashMap();
if (path == null && parameters.containsKey("path") && parameters.get("path") != null) {
path = (String) parameters.get("path");
}
if (path == null) {
throw new NullPointerException("Argument or Parameter missing: path parameters[\"path\"]");
}
if (parameters.containsKey("cursor") && !(parameters.get("cursor") instanceof String)) {
throw new IllegalArgumentException("Bad parameter: cursor must be of type String parameters[\"cursor\"]");
}
if (parameters.containsKey("per_page") && !(parameters.get("per_page") instanceof Long)) {
throw new IllegalArgumentException("Bad parameter: per_page must be of type Long parameters[\"per_page\"]");
}
if (!(path instanceof String)) {
throw new IllegalArgumentException("Bad parameter: path must be of type String parameters[\"path\"]");
}
if (parameters.containsKey("include_children") && !(parameters.get("include_children") instanceof Boolean)) {
throw new IllegalArgumentException("Bad parameter: include_children must be of type Boolean parameters[\"include_children\"]");
}
String urlParts[] = {FilesConfig.getInstance().getApiRoot(), FilesConfig.getInstance().getApiBase(), path};
for (int i = 2; i < urlParts.length; i++) {
try {
urlParts[i] = new URI(null, null, urlParts[i], null).getRawPath();
} catch (URISyntaxException ex) {
// NOOP
}
}
String url = String.format("%s%s/locks/%s", urlParts);
TypeReference> typeReference = new TypeReference>() {};
return FilesClient.requestList(url, RequestMethods.GET, typeReference, parameters, options);
}
/**
* Parameters:
* path (required) - string - Path
* allow_access_by_any_user - boolean - Allow lock to be updated by any user?
* exclusive - boolean - Is lock exclusive?
* recursive - string - Does lock apply to subfolders?
* timeout - int64 - Lock timeout length
*/
public static Lock create() throws RuntimeException {
return create(null, null, null);
}
public static Lock create(String path, HashMap parameters) throws RuntimeException {
return create(path, parameters, null);
}
public static Lock create(HashMap parameters, HashMap options) throws RuntimeException {
return create(null, parameters, options);
}
public static Lock create(String path, HashMap parameters, HashMap options) throws RuntimeException {
parameters = parameters != null ? parameters : new HashMap();
options = options != null ? options : new HashMap();
if (path == null && parameters.containsKey("path") && parameters.get("path") != null) {
path = (String) parameters.get("path");
}
if (path == null) {
throw new NullPointerException("Argument or Parameter missing: path parameters[\"path\"]");
}
if (!(path instanceof String)) {
throw new IllegalArgumentException("Bad parameter: path must be of type String parameters[\"path\"]");
}
if (parameters.containsKey("allow_access_by_any_user") && !(parameters.get("allow_access_by_any_user") instanceof Boolean)) {
throw new IllegalArgumentException("Bad parameter: allow_access_by_any_user must be of type Boolean parameters[\"allow_access_by_any_user\"]");
}
if (parameters.containsKey("exclusive") && !(parameters.get("exclusive") instanceof Boolean)) {
throw new IllegalArgumentException("Bad parameter: exclusive must be of type Boolean parameters[\"exclusive\"]");
}
if (parameters.containsKey("recursive") && !(parameters.get("recursive") instanceof String)) {
throw new IllegalArgumentException("Bad parameter: recursive must be of type String parameters[\"recursive\"]");
}
if (parameters.containsKey("timeout") && !(parameters.get("timeout") instanceof Long)) {
throw new IllegalArgumentException("Bad parameter: timeout must be of type Long parameters[\"timeout\"]");
}
String urlParts[] = {FilesConfig.getInstance().getApiRoot(), FilesConfig.getInstance().getApiBase(), path};
for (int i = 2; i < urlParts.length; i++) {
try {
urlParts[i] = new URI(null, null, urlParts[i], null).getRawPath();
} catch (URISyntaxException ex) {
// NOOP
}
}
String url = String.format("%s%s/locks/%s", urlParts);
TypeReference typeReference = new TypeReference() {};
return FilesClient.requestItem(url, RequestMethods.POST, typeReference, parameters, options);
}
/**
* Parameters:
* token (required) - string - Lock token
*/
public static void delete() throws RuntimeException {
delete(null, null, null);
}
public static void delete(String path, HashMap parameters) throws RuntimeException {
delete(path, parameters, null);
}
public static void delete(HashMap parameters, HashMap options) throws RuntimeException {
delete(null, parameters, options);
}
public static void delete(String path, HashMap parameters, HashMap options) throws RuntimeException {
parameters = parameters != null ? parameters : new HashMap();
options = options != null ? options : new HashMap();
if (path == null && parameters.containsKey("path") && parameters.get("path") != null) {
path = (String) parameters.get("path");
}
if (path == null) {
throw new NullPointerException("Argument or Parameter missing: path parameters[\"path\"]");
}
if (!parameters.containsKey("token") || parameters.get("token") == null) {
throw new NullPointerException("Parameter missing: token parameters[\"token\"]");
}
if (!(path instanceof String)) {
throw new IllegalArgumentException("Bad parameter: path must be of type String parameters[\"path\"]");
}
if (parameters.containsKey("token") && !(parameters.get("token") instanceof String)) {
throw new IllegalArgumentException("Bad parameter: token must be of type String parameters[\"token\"]");
}
String urlParts[] = {FilesConfig.getInstance().getApiRoot(), FilesConfig.getInstance().getApiBase(), path};
for (int i = 2; i < urlParts.length; i++) {
try {
urlParts[i] = new URI(null, null, urlParts[i], null).getRawPath();
} catch (URISyntaxException ex) {
// NOOP
}
}
String url = String.format("%s%s/locks/%s", urlParts);
FilesClient.apiRequest(url, RequestMethods.DELETE, parameters, options);
}
public static void destroy() throws RuntimeException {
destroy(null, null, null);
}
public static void destroy(String path, HashMap parameters, HashMap options) throws RuntimeException {
delete(path, parameters, options);
}
}
© 2015 - 2025 Weber Informatics LLC | Privacy Policy