Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/uploadcare/uploadcare-java
Java API client that handles uploads and further operations with files by wrapping Uploadcare Upload and REST APIs.
https://github.com/uploadcare/uploadcare-java
api client file-upload image-processing image-recognition image-upload java processing sdk upload uploadcare uploader
Last synced: 29 days ago
JSON representation
Java API client that handles uploads and further operations with files by wrapping Uploadcare Upload and REST APIs.
- Host: GitHub
- URL: https://github.com/uploadcare/uploadcare-java
- Owner: uploadcare
- License: apache-2.0
- Created: 2012-12-26T15:07:30.000Z (about 12 years ago)
- Default Branch: master
- Last Pushed: 2024-03-13T17:58:50.000Z (10 months ago)
- Last Synced: 2024-09-18T01:25:06.515Z (4 months ago)
- Topics: api, client, file-upload, image-processing, image-recognition, image-upload, java, processing, sdk, upload, uploadcare, uploader
- Language: Java
- Homepage: https://uploadcare.com
- Size: 837 KB
- Stars: 6
- Watchers: 12
- Forks: 13
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Changelog: HISTORY.md
- License: LICENSE
- Authors: AUTHORS.txt
Awesome Lists containing this project
README
# uploadcare-java
[](https://github.com/uploadcare/uploadcare-java/actions/workflows/build.yml)
[](https://maven-badges.herokuapp.com/maven-central/com.uploadcare/uploadcare)
[](https://www.javadoc.io/doc/com.uploadcare/uploadcare)
[![Uploadcare stack on StackShare][stack-img]][stack]
[stack-img]: http://img.shields.io/badge/tech-stack-0690fa.svg?style=flat
[stack]: https://stackshare.io/uploadcare/stacks/
This is a Java library for Uploadcare.
Supported features:
- Complete file and project APIs v0.6.
- Paginated resources are fetched as `List`.
- CDN path builder.
- File uploading from a local storage, byte arrays, URLs, and signed uploads.
The minimum requirements to build this project are:
1. Gradle 8.2 (you can use `./gradlew` or `.\gradlew.bat` which will download it for you).
2. JDK 1.8 (target is 1.7, so don't use much higher version).
3. Running `./gradlew build` should run successfully.
## Maven
The latest stable library version is available at
[Maven Central](https://central.sonatype.com/artifact/com.uploadcare/uploadcare/).
Include following dependency into your project's `pom.xml`:
```xml
com.uploadcare
uploadcare
3.5.2
```
## Gradle
Include following dependency into your project's `build.gradle`:
```
implementation 'com.uploadcare:uploadcare:3.5.1'
```
If you are using the kotlin style `build.gradle.kts`:
```
implementation("com.uploadcare:uploadcare:3.5.1")
```
## Examples
Get your [API keys](https://uploadcare.com/docs/start/settings/#keys) to proceed with the examples below.
Read class documentation on [javadoc.io](https://www.javadoc.io/doc/com.uploadcare/uploadcare/latest/index.html).
### Basic API Usage
```java
Client client = new Client("publickey", "secretkey");
Project project = client.getProject();
Project.Collaborator owner = project.getOwner();
List published = new ArrayList();
Iterable files = client.getFiles().asIterable();
for (File file : files) {
if (file.isMadePublic()) {
published.add(file.getOriginalFileUrl());
}
}
```
### Building CDN URLs
```java
File file = client.getFile("85b5644f-e692-4855-9db0-8c5a83096e25");
CdnPathBuilder builder = file.cdnPath()
.resizeWidth(200)
.cropCenter(200, 200)
.grayscale();
URI url = Urls.cdn(builder);
```
### File uploads
```java
Client client = Client.demoClient();
java.io.File file = new java.io.File("olympia.jpg");
Uploader uploader = new FileUploader(client, sourceFile);
try {
File file = uploader.upload().save();
System.out.println(file.getOriginalFileUrl());
} catch (UploadFailureException e) {
System.out.println("Upload failed :(");
}
```