Dream Features

Backwards Compatible

[DreamFeature("PUT:feature/{key1}/{key2}")]
public Yield PutFeature(
    DreamContext context, 
    DreamMessage message, 
    Result<DreamMessage> response
) {

    // convert request body into an XML document
    XDoc doc = message.ToDocument();

    // read path parameters
    string key1 = context.GetParam("key1");
    string key2 = context.GetParam("key2");

    // read query parameter from context
    string query = context.GetParam("q", null);

    // rest of the implementation
}

Async Feature Definition

[DreamFeature("PUT:feature/{key1}/{key2}")]
public Yield PutFeature(
    XDoc body, 
    string key1, 
    string key2, 
    string q, 
    Result<DreamMessage> response
) {
    // rest of the implementation
}

Sync Feature Definition

[DreamFeature("PUT:feature/{key1}/{key2}")]
public DreamMessage PutFeature(
    XDoc body, 
    string key1, 
    string key2, 
    string q
) {
    // rest of the implementation
}

Notes

• "verb" and "path" take precedence of similarly named parameters.  So don't use these terms for your parameters!
• Path parameters never return a null value since they are required in the signature.  However, query parameters are not guaranteed to exist.  As with DreamContext.GetParam(), path parameters take precedence over query parameters.