// Path: action/src/main/java/io/cettia/asity/action/Action.java
// @FunctionalInterface
// public interface Action<T> {
// 
//   /**
//    * Some action is taken.
//    */
//   void on(T object);
// 
// }


import io.cettia.asity.action.Action;
import java.nio.ByteBuffer;
import java.util.List;
import java.util.Set;
/*
 * Copyright 2015 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 io.cettia.asity.http;



/**
 * Represents a server-side HTTP request-response exchange.
 * <p/>
 * Implementations are not thread-safe.
 *
 * @author Donghwan Kim
 * @see <a href="http://www.w3.org/Protocols/rfc2616/rfc2616.html">RFC2616 -
 * Hypertext Transfer Protocol -- HTTP/1.1</a>
 */
public interface ServerHttpExchange {

  /**
   * The request URI.
   */
  String uri();

  /**
   * The name of the request method.
   */
  HttpMethod method();

  /**
   * The names of the request headers. HTTP header is not case-sensitive but
   * {@link Set} is case-sensitive.
   */
  Set<String> headerNames();

  /**
   * Returns the first request header associated with the given name.
   */
  String header(String name);

  /**
   * Returns the request headers associated with the given name or empty list
   * if no header is found.
   */
  List<String> headers(String name);

  /**
   * Reads the request body. If the request header, {@code content-type},
   * starts with {@code text/}, the body is read as text, and if not, as
   * binary. In case of text body, the charset is also determined by the same
   * header. If it's not given, {@code ISO-8859-1} is used by default.
   * <p/>
   * The read data will be passed to event handlers as {@link String} if it's
   * text and {@link ByteBuffer} if it's binary attached through
   * {@link ServerHttpExchange#onchunk(Action)}.
   * <p/>
   * This method should be called after adding
   * {@link ServerHttpExchange#onchunk(Action)},
   * {@link ServerHttpExchange#onbody(Action)}, and
   * {@link ServerHttpExchange#onend(Action)} and has no side effect if called
   * more than once.
   */
  ServerHttpExchange read();

  /**
   * Reads the request body as text. The charset is determined by the request
   * header, {@code content-type}. If it's not given, {@code ISO-8859-1} is
   * used by default.
   * <p/>
   * The read data will be passed to event handlers as {@link String} attached
   * through {@link ServerHttpExchange#onchunk(Action)}.
   * <p/>
   * This method should be called after adding
   * {@link ServerHttpExchange#onchunk(Action)},
   * {@link ServerHttpExchange#onbody(Action)}, and
   * {@link ServerHttpExchange#onend(Action)} and has no side effect if called
   * more than once.
   */
  ServerHttpExchange readAsText();

  /**
   * Reads the request body as text using the given charset.
   * <p/>
   * The read data will be passed to event handlers as {@link String} attached
   * through {@link ServerHttpExchange#onchunk(Action)}.
   * <p/>
   * This method should be called after adding
   * {@link ServerHttpExchange#onchunk(Action)},
   * {@link ServerHttpExchange#onbody(Action)}, and
   * {@link ServerHttpExchange#onend(Action)} and has no side effect if called
   * more than once.
   */
  ServerHttpExchange readAsText(String charsetName);

  /**
   * Reads the request body as binary.
   * <p/>
   * The read data will be passed to event handlers as {@link ByteBuffer}
   * attached through {@link ServerHttpExchange#onchunk(Action)}.
   * <p/>
   * This method should be called after adding
   * {@link ServerHttpExchange#onchunk(Action)},
   * {@link ServerHttpExchange#onbody(Action)}, and
   * {@link ServerHttpExchange#onend(Action)} and has no side effect if called
   * more than once.
   */
  ServerHttpExchange readAsBinary();

  /**
   * Attaches an action to be called with a chunk from the request body.
   *
   * @param <T> The allowed data type. {@link String} for text body and {@link ByteBuffer} for
   *           binary body.
   */
// Path: action/src/main/java/io/cettia/asity/action/Action.java
// @FunctionalInterface
// public interface Action<T> {
// 
//   /**
//    * Some action is taken.
//    */
//   void on(T object);
// 
// }


// Path: http/src/main/java/io/cettia/asity/http/ServerHttpExchange.java
import io.cettia.asity.action.Action;
import java.nio.ByteBuffer;
import java.util.List;
import java.util.Set;

/*
 * Copyright 2015 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 io.cettia.asity.http;



/**
 * Represents a server-side HTTP request-response exchange.
 * <p/>
 * Implementations are not thread-safe.
 *
 * @author Donghwan Kim
 * @see <a href="http://www.w3.org/Protocols/rfc2616/rfc2616.html">RFC2616 -
 * Hypertext Transfer Protocol -- HTTP/1.1</a>
 */
public interface ServerHttpExchange {

  /**
   * The request URI.
   */
  String uri();

  /**
   * The name of the request method.
   */
  HttpMethod method();

  /**
   * The names of the request headers. HTTP header is not case-sensitive but
   * {@link Set} is case-sensitive.
   */
  Set<String> headerNames();

  /**
   * Returns the first request header associated with the given name.
   */
  String header(String name);

  /**
   * Returns the request headers associated with the given name or empty list
   * if no header is found.
   */
  List<String> headers(String name);

  /**
   * Reads the request body. If the request header, {@code content-type},
   * starts with {@code text/}, the body is read as text, and if not, as
   * binary. In case of text body, the charset is also determined by the same
   * header. If it's not given, {@code ISO-8859-1} is used by default.
   * <p/>
   * The read data will be passed to event handlers as {@link String} if it's
   * text and {@link ByteBuffer} if it's binary attached through
   * {@link ServerHttpExchange#onchunk(Action)}.
   * <p/>
   * This method should be called after adding
   * {@link ServerHttpExchange#onchunk(Action)},
   * {@link ServerHttpExchange#onbody(Action)}, and
   * {@link ServerHttpExchange#onend(Action)} and has no side effect if called
   * more than once.
   */
  ServerHttpExchange read();

  /**
   * Reads the request body as text. The charset is determined by the request
   * header, {@code content-type}. If it's not given, {@code ISO-8859-1} is
   * used by default.
   * <p/>
   * The read data will be passed to event handlers as {@link String} attached
   * through {@link ServerHttpExchange#onchunk(Action)}.
   * <p/>
   * This method should be called after adding
   * {@link ServerHttpExchange#onchunk(Action)},
   * {@link ServerHttpExchange#onbody(Action)}, and
   * {@link ServerHttpExchange#onend(Action)} and has no side effect if called
   * more than once.
   */
  ServerHttpExchange readAsText();

  /**
   * Reads the request body as text using the given charset.
   * <p/>
   * The read data will be passed to event handlers as {@link String} attached
   * through {@link ServerHttpExchange#onchunk(Action)}.
   * <p/>
   * This method should be called after adding
   * {@link ServerHttpExchange#onchunk(Action)},
   * {@link ServerHttpExchange#onbody(Action)}, and
   * {@link ServerHttpExchange#onend(Action)} and has no side effect if called
   * more than once.
   */
  ServerHttpExchange readAsText(String charsetName);

  /**
   * Reads the request body as binary.
   * <p/>
   * The read data will be passed to event handlers as {@link ByteBuffer}
   * attached through {@link ServerHttpExchange#onchunk(Action)}.
   * <p/>
   * This method should be called after adding
   * {@link ServerHttpExchange#onchunk(Action)},
   * {@link ServerHttpExchange#onbody(Action)}, and
   * {@link ServerHttpExchange#onend(Action)} and has no side effect if called
   * more than once.
   */
  ServerHttpExchange readAsBinary();

  /**
   * Attaches an action to be called with a chunk from the request body.
   *
   * @param <T> The allowed data type. {@link String} for text body and {@link ByteBuffer} for
   *           binary body.
   */
  <T> ServerHttpExchange onchunk(Action<T> action);