JarCastingStash Java Client
Official Java client for the Stash by AppsCode.
Installation
To install the Java client library to your local Maven repository, simply execute:
git clone --recursive https://github.com/stash-client/java
cd java
mvn install
Refer to the official documentation for more information.
Maven users
Add this dependency to your project's POM:
<dependency>
<groupId>com.appscode.stash</groupId>
<artifactId>client-java</artifactId>
<version>0.1.0</version>
<scope>compile</scope>
</dependency>
Gradle users
compile 'com.appscode.stash:client-java:0.1.0'
Others
At first generate the JAR by executing:
git clone --recursive https://github.com/stash-client/java
cd java
mvn package
Then manually install the following JARs:
- target/client-java-1.0.0-SNAPSHOT.jar
- target/lib/*.jar
Example
list all pods:
import com.appscode.stash.client.ApiClient;
import com.appscode.stash.client.ApiException;
import com.appscode.stash.client.Configuration;
import com.appscode.stash.client.apis.StashAppscodeComV1alpha1Api;
import com.appscode.stash.client.models.V1alpha1Restic;
import com.appscode.stash.client.models.V1alpha1ResticList;
import com.appscode.stash.client.util.Config;
import java.io.IOException;
public class Example {
public static void main(String[] args) throws IOException, ApiException {
ApiClient client = Config.defaultClient();
Configuration.setDefaultApiClient(client);
StashAppscodeComV1alpha1Api api = new StashAppscodeComV1alpha1Api();
V1alpha1ResticList list =
api.listResticForAllNamespaces(null, null, null, null, null, null, null, null, null);
for (V1alpha1Restic item : list.getItems()) {
System.out.println(item.getMetadata().getName());
}
}
}
watch on restic object:
import com.appscode.stash.client.ApiClient;
import com.appscode.stash.client.ApiException;
import com.appscode.stash.client.Configuration;
import com.appscode.stash.client.apis.StashAppscodeComV1alpha1Api;
import com.appscode.stash.client.models.V1alpha1Restic;
import com.appscode.stash.client.util.Config;
import com.appscode.stash.client.util.Watch;
import com.google.gson.reflect.TypeToken;
import java.io.IOException;
import java.util.concurrent.TimeUnit;
public class WatchExample {
public static void main(String[] args) throws IOException, ApiException {
ApiClient client = Config.defaultClient();
client.getHttpClient().setReadTimeout(60, TimeUnit.SECONDS);
Configuration.setDefaultApiClient(client);
StashAppscodeComV1alpha1Api api = new StashAppscodeComV1alpha1Api();
Watch<V1alpha1Restic> watch =
Watch.createWatch(
client,
api.listResticForAllNamespacesCall(
null, null, null, null, null, "false", null, null, Boolean.TRUE, null, null),
new TypeToken<Watch.Response<V1alpha1Restic>>() {}.getType());
for (Watch.Response<V1alpha1Restic> item : watch) {
System.out.printf("%s : %s%n", item.type, item.object.getMetadata().getName());
}
}
}
More examples can be found in examples folder. To run examples, run this command:
mvn exec:java -Dexec.mainClass="com.appscode.stash.client.examples.Example"
Documentation
All APIs and Models' documentation can be found at the Generated client's README file
Compatibility
| Kubernetes 1.4 | Kubernetes 1.5 | Kubernetes 1.6 | Kubernetes 1.7 | Kubernetes 1.8 | Kubernetes 1.9 | |
|---|---|---|---|---|---|---|
| 0.1.0 | + | + | + | + | ✓ | - |
Key:
✓Exactly the same features / API objects in both java-client and the Kubernetes version.+java-client has features or api objects that may not be present in the Kubernetes cluster, but everything they have in common will work.-The Kubernetes cluster has features the java-client library can't use (additional API objects, etc).
See the CHANGELOG for a detailed description of changes between java-client versions.
Community, Support, Discussion
We use Slack for public discussions. To chit chat with us or the rest of the community, join us in the AppsCode Slack team channel #stash. To sign up, use our Slack inviter.
If you have any problem with the package or any suggestions, please file an issue.
Development
Update client
To update the client clone the gen repo and run this command at the root of this repo:
../gen/openapi/autoupdate.sh