Class

com.avsystem.commons.rest

BodyMethodTag

Related Doc: package rest

Permalink

sealed abstract class BodyMethodTag extends HttpMethodTag

Base trait for annotations representing HTTP methods which may define a HTTP body. This includes PUT, POST, PATCH and DELETE. Parameters of REST methods annotated with one of these tags are by default serialized into JSON (through encoding to JsonValue) and combined into JSON object that is sent as HTTP body.

Parameters may also contribute to URL path, HTTP headers and query parameters if annotated as Path, Header or Query.

REST method may also take a single parameter representing the entire HTTP body. Such parameter must be annotated as Body and must be the only body parameter of that method. Value of this parameter will be encoded as HttpBody which doesn't necessarily have to be JSON (it may define its own MIME type).

Example:
  1. trait SomeRestApi {
      @POST("users/create") def createUser(@Body user: User): Future[Unit]
      @PATCH("users/update") def updateUser(id: String, name: String): Future[User]
    }
    object SomeRestApi extends RestApiCompanion[SomeRestApi]
Linear Supertypes
Known Subclasses
Ordering
  1. Alphabetic
  2. By Inheritance
Inherited
  1. BodyMethodTag
  2. HttpMethodTag
  3. AnnotationAggregate
  4. RestMethodTag
  5. RpcTag
  6. RealSymAnnotation
  7. StaticAnnotation
  8. Annotation
  9. AnyRef
  10. Any
  1. Hide All
  2. Show All
Visibility
  1. Public
  2. All

Type Members

  1. abstract type Implied

    Permalink
    Definition Classes
    AnnotationAggregate

Abstract Value Members

  1. abstract def path: String

    Permalink

    HTTP URL path segment associated with REST method annotated with this tag.

    HTTP URL path segment associated with REST method annotated with this tag. This path may be multipart (i.e. contain slashes). It may also be empty which means that this particular REST method does not contribute anything to URL path. Any special characters will be URL-encoded when creating HTTP request. If path is not specified explicitly, method name is used (the actual method name, not rpcName).

    Definition Classes
    RestMethodTag
    Annotations
    @defaultsToName()
    Example:
    1. trait SomeRestApi {
        @GET("users/find")
        def findUser(userId: String): Future[User]
      }
      object SomeRestApi extends RestApiCompanion[SomeRestApi]

Concrete Value Members

  1. final def !=(arg0: Any): Boolean

    Permalink
    Definition Classes
    AnyRef → Any
  2. final def ##(): Int

    Permalink
    Definition Classes
    AnyRef → Any
  3. final def ==(arg0: Any): Boolean

    Permalink
    Definition Classes
    AnyRef → Any
  4. final def asInstanceOf[T0]: T0

    Permalink
    Definition Classes
    Any
  5. def clone(): AnyRef

    Permalink
    Attributes
    protected[java.lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  6. final def eq(arg0: AnyRef): Boolean

    Permalink
    Definition Classes
    AnyRef
  7. def equals(arg0: Any): Boolean

    Permalink
    Definition Classes
    AnyRef → Any
  8. def finalize(): Unit

    Permalink
    Attributes
    protected[java.lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( classOf[java.lang.Throwable] )
  9. final def getClass(): Class[_]

    Permalink
    Definition Classes
    AnyRef → Any
  10. def hashCode(): Int

    Permalink
    Definition Classes
    AnyRef → Any
  11. final def isInstanceOf[T0]: Boolean

    Permalink
    Definition Classes
    Any
  12. val method: HttpMethod

    Permalink
    Definition Classes
    HttpMethodTag
  13. final def ne(arg0: AnyRef): Boolean

    Permalink
    Definition Classes
    AnyRef
  14. final def notify(): Unit

    Permalink
    Definition Classes
    AnyRef
  15. final def notifyAll(): Unit

    Permalink
    Definition Classes
    AnyRef
  16. final def synchronized[T0](arg0: ⇒ T0): T0

    Permalink
    Definition Classes
    AnyRef
  17. def toString(): String

    Permalink
    Definition Classes
    AnyRef → Any
  18. final def wait(): Unit

    Permalink
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  19. final def wait(arg0: Long, arg1: Int): Unit

    Permalink
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  20. final def wait(arg0: Long): Unit

    Permalink
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )

Inherited from HttpMethodTag

Inherited from AnnotationAggregate

Inherited from RestMethodTag

Inherited from RpcTag

Inherited from RealSymAnnotation

Inherited from StaticAnnotation

Inherited from Annotation

Inherited from AnyRef

Inherited from Any

Ungrouped