ratpack.http.MutableHeaders Maven / Gradle / Ivy

Show more of this group Show more artifacts with this name
Show all versions of ratpack-core Show documentation

The core HTTP and composition mechanisms of Ratpack

There is a newer version: 2.0.0-rc-1

/*
 * Copyright 2013 the original author or authors.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *    http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package ratpack.http;

import java.util.Date;

/**
 * A set of HTTP headers that can be changed.
 */
public interface MutableHeaders extends Headers {

  /**
   * Adds a new header with the specified name and value.
   * 
   * Will not replace any existing values for the header.
   *
   * @param name The name of the header
   * @param value The value of the header
   * @return this
   */
  MutableHeaders add(CharSequence name, Object value);

  /**
   * Sets the (only) value for the header with the specified name.
   * 

   * All existing values for the same header will be removed.
   *
   * @param name The name of the header
   * @param value The value of the header
   * @return this
   */
  MutableHeaders set(CharSequence name, Object value);

  /**
   * Set a header with the given date as the value.
   *
   * @param name The name of the header
   * @param value The date value
   * @return this
   */
  MutableHeaders setDate(CharSequence name, Date value);

  /**
   * Sets a new header with the specified name and values.
   * 
   * All existing values for the same header will be removed.
   *
   * @param name The name of the header
   * @param values The values of the header
   * @return this
   */
  MutableHeaders set(CharSequence name, Iterable values);

  /**
   * Removes the header with the specified name.
   *
   * @param name The name of the header to remove.
   * @return this
   */
  MutableHeaders remove(CharSequence name);

  /**
   * Removes all headers from this message.
   *
   * @return this
   */
  MutableHeaders clear();

  MutableHeaders copy(Headers headers);

}