Class

io.udash.rest

BodyMethodTag

Related Doc: package rest

Permalink

sealed abstract class BodyMethodTag extends HttpMethodTag

Base trait for annotations representing HTTP methods which may define an 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 with 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 media 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 must already be URL-encoded (spaces should be encoded as %20, not as +). 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
    @HotSpotIntrinsicCandidate() @throws( ... )
  6. final def eq(arg0: AnyRef): Boolean

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

    Permalink
    Definition Classes
    AnyRef → Any
  8. final def getClass(): Class[_]

    Permalink
    Definition Classes
    AnyRef → Any
    Annotations
    @HotSpotIntrinsicCandidate()
  9. def hashCode(): Int

    Permalink
    Definition Classes
    AnyRef → Any
    Annotations
    @HotSpotIntrinsicCandidate()
  10. final def isInstanceOf[T0]: Boolean

    Permalink
    Definition Classes
    Any
  11. val method: HttpMethod

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

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

    Permalink
    Definition Classes
    AnyRef
    Annotations
    @HotSpotIntrinsicCandidate()
  14. final def notifyAll(): Unit

    Permalink
    Definition Classes
    AnyRef
    Annotations
    @HotSpotIntrinsicCandidate()
  15. final def synchronized[T0](arg0: ⇒ T0): T0

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

    Permalink
    Definition Classes
    AnyRef → Any
  17. final def wait(arg0: Long, arg1: Int): Unit

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

    Permalink
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  19. final def wait(): Unit

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

Deprecated Value Members

  1. def finalize(): Unit

    Permalink
    Attributes
    protected[java.lang]
    Definition Classes
    AnyRef
    Annotations
    @Deprecated @deprecated @throws( classOf[java.lang.Throwable] )
    Deprecated

    (Since version ) see corresponding Javadoc for more information.

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