{"id":26758385,"url":"https://github.com/voyagermesh/java","last_synced_at":"2025-03-28T16:19:27.097Z","repository":{"id":57717405,"uuid":"129573038","full_name":"voyagermesh/java","owner":"voyagermesh","description":"Official Java client library for Voyager by AppsCode","archived":false,"fork":false,"pushed_at":"2018-06-22T23:54:24.000Z","size":330,"stargazers_count":2,"open_issues_count":1,"forks_count":0,"subscribers_count":4,"default_branch":"master","last_synced_at":"2023-10-29T04:34:45.273Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://appscode.com/products/voyager/","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/voyagermesh.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-04-15T03:18:02.000Z","updated_at":"2020-04-26T19:50:04.000Z","dependencies_parsed_at":"2022-09-05T20:20:45.675Z","dependency_job_id":null,"html_url":"https://github.com/voyagermesh/java","commit_stats":null,"previous_names":["voyager-client/java"],"tags_count":1,"template":null,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/voyagermesh%2Fjava","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/voyagermesh%2Fjava/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/voyagermesh%2Fjava/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/voyagermesh%2Fjava/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/voyagermesh","download_url":"https://codeload.github.com/voyagermesh/java/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246059313,"owners_count":20717085,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-03-28T16:19:26.552Z","updated_at":"2025-03-28T16:19:27.074Z","avatar_url":"https://github.com/voyagermesh.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Voyager Java Client\n\n[![Build Status](https://travis-ci.org/voyager-client/java.svg?branch=master)](https://travis-ci.org/voyager-client/java)\n[![Client Capabilities](https://img.shields.io/badge/Kubernetes%20client-Silver-blue.svg?style=flat\u0026colorB=C0C0C0\u0026colorA=306CE8)](http://bit.ly/kubernetes-client-capabilities-badge)\n[![Maven Central](https://img.shields.io/maven-central/v/com.appscode.voyager/client-java.svg?label=Maven%20Central)](http://search.maven.org/#search%7Cga%7C1%7Cg%3A%22com.appscode.voyager%22%20a%3A%22client-java%22)\n\nOfficial Java client for the [Voyager by AppsCode](https://appscode.com/products/voyager/) - Secure HAProxy Ingress Controller for Kubernetes.\n\n## Installation\n\nTo install the Java client library to your local Maven repository, simply execute:\n\n```shell\ngit clone --recursive https://github.com/voyager-client/java\ncd java\nmvn install\n```\n\nRefer to the [official documentation](https://maven.apache.org/plugins/maven-deploy-plugin/usage.html) for more information.\n\n### Maven users\n\nAdd this dependency to your project's POM:\n\n```xml\n\u003cdependency\u003e\n    \u003cgroupId\u003ecom.appscode.voyager\u003c/groupId\u003e\n    \u003cartifactId\u003eclient-java\u003c/artifactId\u003e\n    \u003cversion\u003e0.1.0\u003c/version\u003e\n    \u003cscope\u003ecompile\u003c/scope\u003e\n\u003c/dependency\u003e\n```\n\n### Gradle users\n\n```groovy\ncompile 'com.appscode.voyager:client-java:0.1.0'\n```\n\n### Others\n\nAt first generate the JAR by executing:\n\n```\ngit clone --recursive https://github.com/voyager-client/java\ncd java\nmvn package\n```\n\nThen manually install the following JARs:\n\n* target/client-java-1.0.0-SNAPSHOT.jar\n* target/lib/*.jar\n\n## Example\n\nlist all pods:\n\n```java\nimport com.appscode.voyager.client.ApiClient;\nimport com.appscode.voyager.client.ApiException;\nimport com.appscode.voyager.client.Configuration;\nimport com.appscode.voyager.client.apis.VoyagerAppscodeComV1beta1Api;\nimport com.appscode.voyager.client.models.V1beta1Ingress;\nimport com.appscode.voyager.client.models.V1beta1IngressList;\nimport com.appscode.voyager.client.util.Config;\nimport java.io.IOException;\n\npublic class Example {\n  public static void main(String[] args) throws IOException, ApiException {\n    ApiClient client = Config.defaultClient();\n    Configuration.setDefaultApiClient(client);\n\n    VoyagerAppscodeComV1beta1Api api = new VoyagerAppscodeComV1beta1Api();\n    V1beta1IngressList list =\n        api.listIngressForAllNamespaces(null, null, null, null, null, null, null, null, null);\n    for (V1beta1Ingress item : list.getItems()) {\n      System.out.println(item.getMetadata().getName());\n    }\n  }\n}\n```\n\nwatch on ingress object:\n\n```java\nimport com.appscode.voyager.client.ApiClient;\nimport com.appscode.voyager.client.ApiException;\nimport com.appscode.voyager.client.Configuration;\nimport com.appscode.voyager.client.apis.VoyagerAppscodeComV1beta1Api;\nimport com.appscode.voyager.client.models.V1beta1Ingress;\nimport com.appscode.voyager.client.util.Config;\nimport com.appscode.voyager.client.util.Watch;\nimport com.google.gson.reflect.TypeToken;\nimport java.io.IOException;\nimport java.util.concurrent.TimeUnit;\n\npublic class WatchExample {\n  public static void main(String[] args) throws IOException, ApiException {\n    ApiClient client = Config.defaultClient();\n    client.getHttpClient().setReadTimeout(60, TimeUnit.SECONDS);\n    Configuration.setDefaultApiClient(client);\n\n    VoyagerAppscodeComV1beta1Api api = new VoyagerAppscodeComV1beta1Api();\n\n    Watch\u003cV1beta1Ingress\u003e watch =\n        Watch.createWatch(\n            client,\n            api.listIngressForAllNamespacesCall(\n                null, null, null, null, null, \"false\", null, null, Boolean.TRUE, null, null),\n            new TypeToken\u003cWatch.Response\u003cV1beta1Ingress\u003e\u003e() {}.getType());\n\n    for (Watch.Response\u003cV1beta1Ingress\u003e item : watch) {\n      System.out.printf(\"%s : %s%n\", item.type, item.object.getMetadata().getName());\n    }\n  }\n}\n```\n\nMore examples can be found in [examples](examples/) folder. To run examples, run this command:\n\n```shell\nmvn exec:java -Dexec.mainClass=\"com.appscode.voyager.client.examples.Example\"\n```\n\n## Documentation\n\nAll APIs and Models' documentation can be found at the [Generated client's README file](kubernetes/README.md)\n\n## Compatibility\n\n|                          | Kubernetes 1.4 | Kubernetes 1.5 | Kubernetes 1.6 | Kubernetes 1.7 | Kubernetes 1.8 | Kubernetes 1.9 |\n|--------------------------|----------------|----------------|----------------|----------------|----------------|----------------|\n| java-client 0.1.0 | +              | +              | +              | +              | ✓              | -              |\n\nKey:\n\n* `✓` Exactly the same features / API objects in both java-client and the Kubernetes\n  version.\n* `+` java-client has features or api objects that may not be present in the\n  Kubernetes cluster, but everything they have in common will work.\n* `-` The Kubernetes cluster has features the java-client library can't use\n  (additional API objects, etc).\n\nSee the [CHANGELOG](./CHANGELOG.md) for a detailed description of changes\nbetween java-client versions.\n\n## Community, Support, Discussion\n\nWe use Slack for public discussions. To chit chat with us or the rest of the community, join us in the [AppsCode Slack team](https://appscode.slack.com/messages/C0XQFLGRM/details/) channel `#general`. To sign up, use our [Slack inviter](https://slack.appscode.com/).\n\nIf you have any problem with the package or any suggestions, please file an [issue](https://github.com/voyager-client/java/issues).\n\n# Development\n\n## Update client\n\nTo update the client clone the `gen` repo and run this command at the root of this repo:\n\n```bash\n../gen/openapi/autoupdate.sh\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvoyagermesh%2Fjava","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvoyagermesh%2Fjava","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvoyagermesh%2Fjava/lists"}