/*
 * Copyright (c) 2011-2019 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.eventbus;

import io.vertx.codegen.annotations.DataObject;
import io.vertx.codegen.annotations.GenIgnore;
import io.vertx.core.MultiMap;
import io.vertx.core.impl.Arguments;
import io.vertx.core.json.JsonObject;

import java.util.Map;
import java.util.Objects;

Delivery options are used to configure message delivery.

Delivery options allow to configure delivery timeout and message codec name, and to provide any headers that you wish to send with the message.

Author:Tim Fox
/** * Delivery options are used to configure message delivery. * <p> * Delivery options allow to configure delivery timeout and message codec name, and to provide any headers * that you wish to send with the message. * * @author <a href="http://tfox.org">Tim Fox</a> */
@DataObject public class DeliveryOptions {
The default send timeout.
/** * The default send timeout. */
public static final long DEFAULT_TIMEOUT = 30 * 1000;
Whether the message should be delivered to local consumers only by default = false.
/** * Whether the message should be delivered to local consumers only by default = false. */
public static final boolean DEFAULT_LOCAL_ONLY = false; private long timeout = DEFAULT_TIMEOUT; private String codecName; private MultiMap headers; private boolean localOnly = DEFAULT_LOCAL_ONLY;
Default constructor
/** * Default constructor */
public DeliveryOptions() { }
Copy constructor
Params:
  • other – the options to copy
/** * Copy constructor * * @param other the options to copy */
public DeliveryOptions(DeliveryOptions other) { this.timeout = other.getSendTimeout(); this.codecName = other.getCodecName(); this.headers = other.getHeaders(); this.localOnly = other.localOnly; }
Create a delivery options from JSON
Params:
  • json – the JSON
/** * Create a delivery options from JSON * * @param json the JSON */
public DeliveryOptions(JsonObject json) { this.timeout = json.getLong("timeout", DEFAULT_TIMEOUT); this.codecName = json.getString("codecName", null); JsonObject hdrs = json.getJsonObject("headers", null); if (hdrs != null) { headers = MultiMap.caseInsensitiveMultiMap(); for (Map.Entry<String, Object> entry: hdrs) { if (!(entry.getValue() instanceof String)) { throw new IllegalStateException("Invalid type for message header value " + entry.getValue().getClass()); } headers.set(entry.getKey(), (String)entry.getValue()); } } this.localOnly = json.getBoolean("localOnly", DEFAULT_LOCAL_ONLY); }
Convert to JSON.
Returns:the JSON
/** * Convert to JSON. * * @return the JSON */
public JsonObject toJson() { JsonObject json = new JsonObject(); json.put("timeout", timeout); if (codecName != null) json.put("codecName", codecName); if (headers != null) { JsonObject hJson = new JsonObject(); headers.entries().forEach(entry -> hJson.put(entry.getKey(), entry.getValue())); json.put("headers", hJson); } json.put("localOnly", localOnly); return json; }
Get the send timeout.

When sending a message with a response handler a send timeout can be provided. If no response is received within the timeout the handler will be called with a failure.

Returns: the value of send timeout
/** * Get the send timeout. * <p> * When sending a message with a response handler a send timeout can be provided. If no response is received * within the timeout the handler will be called with a failure. * * @return the value of send timeout */
public long getSendTimeout() { return timeout; }
Set the send timeout.
Params:
  • timeout – the timeout value, in ms.
Returns: a reference to this, so the API can be used fluently
/** * Set the send timeout. * * @param timeout the timeout value, in ms. * @return a reference to this, so the API can be used fluently */
public DeliveryOptions setSendTimeout(long timeout) { Arguments.require(timeout >= 1, "sendTimeout must be >= 1"); this.timeout = timeout; return this; }
Get the codec name.

When sending or publishing a message a codec name can be provided. This must correspond with a previously registered message codec. This allows you to send arbitrary objects on the event bus (e.g. POJOs).

Returns: the codec name
/** * Get the codec name. * <p> * When sending or publishing a message a codec name can be provided. This must correspond with a previously registered * message codec. This allows you to send arbitrary objects on the event bus (e.g. POJOs). * * @return the codec name */
public String getCodecName() { return codecName; }
Set the codec name.
Params:
  • codecName – the codec name
Returns: a reference to this, so the API can be used fluently
/** * Set the codec name. * * @param codecName the codec name * @return a reference to this, so the API can be used fluently */
public DeliveryOptions setCodecName(String codecName) { this.codecName = codecName; return this; }
Add a message header.

Message headers can be sent with any message and will be accessible with Message.headers at the recipient.

Params:
  • key – the header key
  • value – the header value
Returns: a reference to this, so the API can be used fluently
/** * Add a message header. * <p> * Message headers can be sent with any message and will be accessible with {@link io.vertx.core.eventbus.Message#headers} * at the recipient. * * @param key the header key * @param value the header value * @return a reference to this, so the API can be used fluently */
public DeliveryOptions addHeader(String key, String value) { checkHeaders(); Objects.requireNonNull(key, "no null key accepted"); Objects.requireNonNull(value, "no null value accepted"); headers.add(key, value); return this; }
Set message headers from a multi-map.
Params:
  • headers – the headers
Returns: a reference to this, so the API can be used fluently
/** * Set message headers from a multi-map. * * @param headers the headers * @return a reference to this, so the API can be used fluently */
@GenIgnore public DeliveryOptions setHeaders(MultiMap headers) { this.headers = headers; return this; }
Get the message headers
Returns: the headers
/** * Get the message headers * * @return the headers */
@GenIgnore public MultiMap getHeaders() { return headers; } private void checkHeaders() { if (headers == null) { headers = MultiMap.caseInsensitiveMultiMap(); } }
Returns:whether the message should be delivered to local consumers only
/** * @return whether the message should be delivered to local consumers only */
public boolean isLocalOnly() { return localOnly; }
Whether a message should be delivered to local consumers only. Defaults to false.

This option is effective in clustered mode only and does not apply to reply messages.

Params:
  • localOnly – true to deliver to local consumers only, false otherwise
Returns:a reference to this, so the API can be used fluently
/** * Whether a message should be delivered to local consumers only. Defaults to {@code false}. * * <p> * <strong>This option is effective in clustered mode only and does not apply to reply messages</strong>. * * @param localOnly {@code true} to deliver to local consumers only, {@code false} otherwise * @return a reference to this, so the API can be used fluently */
public DeliveryOptions setLocalOnly(boolean localOnly) { this.localOnly = localOnly; return this; } }