/*
* Copyright (c) 2011-2017 Contributors to the Eclipse Foundation
*
* This program and the accompanying materials are made available under the
* terms of the Eclipse Public License 2.0 which is available at
* http://www.eclipse.org/legal/epl-2.0, or the Apache License, Version 2.0
* which is available at https://www.apache.org/licenses/LICENSE-2.0.
*
* SPDX-License-Identifier: EPL-2.0 OR Apache-2.0
*/
package io.vertx.core.net;
import io.vertx.codegen.annotations.DataObject;
import io.vertx.core.Vertx;
import io.vertx.core.buffer.Buffer;
import io.vertx.core.impl.VertxInternal;
import io.vertx.core.json.JsonObject;
import io.vertx.core.net.impl.KeyStoreHelper;
import javax.net.ssl.KeyManagerFactory;
Key or trust store options configuring private key and/or certificates based on Java Keystore files.
When used as a key store, it should point to a store containing a private key and its certificate.
When used as a trust store, it should point to a store containing a list of trusted certificates.
The store can either be loaded by Vert.x from the filesystem:
HttpServerOptions options = HttpServerOptions.httpServerOptions();
options.setKeyStore(new JKSOptions().setPath("/mykeystore.jks").setPassword("foo"));
Or directly provided as a buffer:
Buffer store = vertx.fileSystem().readFileSync("/mykeystore.jks");
options.setKeyStore(new JKSOptions().setValue(store).setPassword("foo"));
Author: Julien Viet, Tim Fox
/**
* Key or trust store options configuring private key and/or certificates based on Java Keystore files.
* <p>
* When used as a key store, it should point to a store containing a private key and its certificate.
* When used as a trust store, it should point to a store containing a list of trusted certificates.
* <p>
* The store can either be loaded by Vert.x from the filesystem:
* <p>
* <pre>
* HttpServerOptions options = HttpServerOptions.httpServerOptions();
* options.setKeyStore(new JKSOptions().setPath("/mykeystore.jks").setPassword("foo"));
* </pre>
*
* Or directly provided as a buffer:
* <p>
*
* <pre>
* Buffer store = vertx.fileSystem().readFileSync("/mykeystore.jks");
* options.setKeyStore(new JKSOptions().setValue(store).setPassword("foo"));
* </pre>
*
* @author <a href="mailto:julien@julienviet.com">Julien Viet</a>
* @author <a href="http://tfox.org">Tim Fox</a>
*/
@DataObject(generateConverter = true)
public class JksOptions implements KeyCertOptions, TrustOptions, Cloneable {
private String password;
private String path;
private Buffer value;
Default constructor
/**
* Default constructor
*/
public JksOptions() {
super();
}
Copy constructor
Params: - other – the options to copy
/**
* Copy constructor
*
* @param other the options to copy
*/
public JksOptions(JksOptions other) {
super();
this.password = other.getPassword();
this.path = other.getPath();
this.value = other.getValue();
}
Create options from JSON
Params: - json – the JSON
/**
* Create options from JSON
*
* @param json the JSON
*/
public JksOptions(JsonObject json) {
super();
JksOptionsConverter.fromJson(json, this);
}
Convert to JSON
Returns: the JSON
/**
* Convert to JSON
*
* @return the JSON
*/
public JsonObject toJson() {
JsonObject json = new JsonObject();
JksOptionsConverter.toJson(this, json);
return json;
}
Returns: the password for the key store
/**
* @return the password for the key store
*/
public String getPassword() {
return password;
}
Set the password for the key store
Params: - password – the password
Returns: a reference to this, so the API can be used fluently
/**
* Set the password for the key store
*
* @param password the password
* @return a reference to this, so the API can be used fluently
*/
public JksOptions setPassword(String password) {
this.password = password;
return this;
}
Get the path to the ksy store
Returns: the path
/**
* Get the path to the ksy store
*
* @return the path
*/
public String getPath() {
return path;
}
Set the path to the key store
Params: - path – the path
Returns: a reference to this, so the API can be used fluently
/**
* Set the path to the key store
*
* @param path the path
* @return a reference to this, so the API can be used fluently
*/
public JksOptions setPath(String path) {
this.path = path;
return this;
}
Get the key store as a buffer
Returns: the key store as a buffer
/**
* Get the key store as a buffer
*
* @return the key store as a buffer
*/
public Buffer getValue() {
return value;
}
Set the key store as a buffer
Params: - value – the key store as a buffer
Returns: a reference to this, so the API can be used fluently
/**
* Set the key store as a buffer
*
* @param value the key store as a buffer
* @return a reference to this, so the API can be used fluently
*/
public JksOptions setValue(Buffer value) {
this.value = value;
return this;
}
@Override
public boolean equals(Object o) {
if (this == o) {
return true;
}
if (!(o instanceof JksOptions)) {
return false;
}
JksOptions that = (JksOptions) o;
if (password != null ? !password.equals(that.password) : that.password != null) {
return false;
}
if (path != null ? !path.equals(that.path) : that.path != null) {
return false;
}
if (value != null ? !value.equals(that.value) : that.value != null) {
return false;
}
return true;
}
@Override
public int hashCode() {
int result = 1;
result += 31 * result + (password != null ? password.hashCode() : 0);
result += 31 * result + (path != null ? path.hashCode() : 0);
result += 31 * result + (value != null ? value.hashCode() : 0);
return result;
}
@Override
public JksOptions copy() {
return clone();
}
@Override
public JksOptions clone() {
return new JksOptions(this);
}
}