Reply

java.lang.Object
- se.rupy.http.Reply

```
public class Reply
extends java.lang.Object
```
HTTP response. Non-blocking asynchronous; if you don't change the code or write output, the reply will not be sent at the end of the filter method and the client will wait for a response indefinitely, until a network timeout or a reply wakeup sends a response. The order of execution is header(String, String), code(String) and finally output(). If you call the code(String) or output() method, the reply will flush output, so then you won't be able to do an asynchronous reply, call Event.hold() to keep the reply open until Output.finish() is called. To wakeup a dormant asynchronous event use wakeup().

Field Summary

Fields
Modifier and Type	Field and Description
`static int`	`CLOSED` If the reply has been closed, try increasing timeout variable.
`static int`	`COMPLETE` If the reply has been completed.
`static int`	`OK` The reply was successfully awakened.
`static int`	`WORKING` If the reply has a thread writing already you can automatically queue wakeup with `wakeup(boolean)` to assure the wakeup is successful.

Method Summary

Methods
Modifier and Type	Method and Description
`java.lang.String`	`code()`
`void`	`code(java.lang.String code)` Important: call `header(String, String)` before you call this.
`void`	`header(java.lang.String name, java.lang.String value)` This has to be called before `output()` to have effect.
`Output`	`output()` Calls `output(0)`.
`Output`	`output(long length)` Important: call `header(String, String)` and `code(String)` first, in that order, this method is the point of no return for delivery of a request.
`java.lang.String`	`toString()`
`java.lang.String`	`type()`
`void`	`type(java.lang.String type)` This has to be called before `output()` to have effect.
`int`	`wakeup()`
`int`	`wakeup(boolean queue)` To send data asynchronously, call this and the event will be re-filtered.

Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Field Detail
  - WORKING
```
public static final int WORKING
```
    If the reply has a thread writing already you can automatically queue wakeup with wakeup(boolean) to assure the wakeup is successful.
    
    See Also:
    Constant Field Values
  - OK
```
public static final int OK
```
    The reply was successfully awakened.
    
    See Also:
    Constant Field Values
  - COMPLETE
```
public static final int COMPLETE
```
    If the reply has been completed. This means the Event is no longer available for wakeup and should probably be removed from the list, wakeup(boolean) ignores this.
    
    See Also:
    Constant Field Values
  - CLOSED
```
public static final int CLOSED
```
    If the reply has been closed, try increasing timeout variable. This means the Event is no longer available for wakeup and should probably be removed from the list.
    
    See Also:
    Constant Field Values
- Method Detail
  - code
```
public java.lang.String code()
```
  - code
```
public void code(java.lang.String code)
          throws java.io.IOException
```
    Important: call header(String, String) before you call this. If you manually set a code, the reply will flush even if empty. So do not call this if you wan't to reply asynchronously. For example if you want to redirect a browser.
```
 public void filter(Event event) throw Event {
     event.reply().header("Location", "/login");
     event.reply().code("302 Found");
     throw event; // stop the chain
 }
 
```
    Parameters:
    code -
    
    Throws:
    
    java.io.IOException
  - type
```
public java.lang.String type()
```
  - type
```
public void type(java.lang.String type)
```
    This has to be called before output() to have effect.
    
    Parameters:
    type -
  - header
```
public void header(java.lang.String name,
          java.lang.String value)
```
    This has to be called before output() to have effect.
    
    Parameters:
    name -
    value -
  - output
```
public Output output()
              throws java.io.IOException
```
    Calls output(0).
    
    Returns:
    the output stream.
    
    Throws:
    
    java.io.IOException
  - output
```
public Output output(long length)
              throws java.io.IOException
```
    Important: call header(String, String) and code(String) first, in that order, this method is the point of no return for delivery of a request. It enables OP_WRITE and writes the headers immediately.
    
    Parameters:
    length - if you want to write fixed length data
    
    Returns:
    the output stream.
    
    Throws:
    
    java.io.IOException
  - wakeup
```
public int wakeup()
```
  - wakeup
```
public int wakeup(boolean queue)
```
    To send data asynchronously, call this and the event will be re-filtered. Just make sure you didn't already flush the reply and that you are ready to catch the event when it recycles in Service.filter(Event)!
    
    The queue parameter is used for 2 things:
    
    - To make sure a multihomed fork latch finishes, see how Root uses it under the hood.
    - Fast async-async chains that reply quicker than the calling thread, when calling f.ex. Root on localhost.
    
    Parameters:
    queue - Automatically wakeup this event later if WORKING.
    
    Returns:
    The status of the wakeup call. OK, COMPLETE, CLOSED or WORKING
  - toString
```
public java.lang.String toString()
```
    Overrides:
    
    toString in class java.lang.Object

Class Reply

Field Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

WORKING

OK

COMPLETE

CLOSED

Method Detail

code

code

type

type

header

output

output

wakeup

wakeup

toString