The Java library is available as a Maven JAR artifact at Maven Central.
Two alternatives:
Requirements:
HTTP/2 over TLS is optional but recommended from a security perspective.
<?xml version="1.0" encoding="utf-8" ?>
<services version="1.0">
<container version="1.0" id="default">
<http>
<server id="default" port="4443">
<ssl>
<private-key-file>/path/to/vespa/home/conf/jdisc_container/private-key.pem</private-key-file>
<certificate-file>/path/to/vespa/home/conf/jdisc_container/certificate.pem</certificate-file>
<ca-certificates-file>/path/to/vespa/home/conf/jdisc_container/ca-certificates.pem</ca-certificates-file>
</ssl>
</server>
</http>
<document-api/>
</container>
</services>
<?xml version="1.0" encoding="utf-8" ?>
<services version="1.0">
<container version="1.0" id="default">
<document-api/>
</container>
</services>
The Javadoc for the programmatic API is available at javadoc.io.
See output of $ vespa-feed-client --help
for usage of command line client.
Add vespa-feed-client as dependency to your Maven (or other build system using Maven for dependency management):
<dependency> <groupId>com.yahoo.vespa</groupId> <artifactId>vespa-feed-client</artifactId> <version>7.xxx.xx</version> </dependency>
Code examples are listed in the vespa-feed-client source code at Github.
$ vespa-feed-client --file /path/to/json/file --endpoint https://container-endpoint:4443/ --connections 4 \ --certificate cert.pem --private-key key.pem --ca-certificates ca.pemThe input must be either a proper JSON array, or a series, of JSON feed operations (JSONL), in the format described for the Vespa feed client here.
$ vespa-feed-client --file /path/to/json/file --endpoint http://container-endpoint:8080/ --connections 4
See the dedicated documentation for vespa-hadoop library.