Crate dce_macro 

Dce macros

api(): proc_macro_attribute

An attribute-like macro, you can use it to define api, it will auto bind the controller func.

Parameters:

• path &str:
  The route path, it will be the controller func name if omitted, the style like “part1/part2”, and support path params like the table below:

example	matched	unmatched	description
{id}/detail	1/detail	1 1/info	required param, it could be every place in path
fruit/{target?}	fruit fruit/apple	vegetable	optional param, it must be end of the path
fruit/{targets*}	fruit fruit/apple/banana	vegetable	optional vec param, it must be end of the path
fruit/{targets+}	fruit/apple fruit/apple/banana	fruit vegetable	required vec param, it must be end of the path
fruit/{targets+}.|html	fruit/apple fruit/apple.html	fruit/apple.json	support non suffix or the “.html” suffix but not others
fruit/{targets+}.html|json	fruit/apple.html fruit/apple/banana.json	fruit/apple	support the “.html” or “.json” suffixes but not non or others

• serializer Vec/struct:
  Response body data serializer, use to serialize the DTO into sequences, like JsonSerializer{}. It will be UnreachableSerializer{} if not defined.

• deserializer Vec/struct:
  Request body data deserializer, use to deserialize the sequences into DTO, like JsonSerializer{}. It will be UnreachableSerializer{} if not defined.

• id &str:
  Api ID, sometimes you want to use the shorter sign to mark an api, then you can define an id for it. Default value "".

• omission bool:
  Define it is an omission part, for example api("home/index", omission = true) means you must use the path “home” to access it, because the “index” part is omission. Default value false.

• redirect &str:
  Define the api should redirect to another one. Default value "".

• name &str:
  Name the api. It will be the last part of path if not defined.

• unresponsive bool:
  Define the api should not response, sometimes we want request a tcp or another long connection type service but not need response. Default value false.

The params order is up to down, and you can use assignment expression style define it to break the fixed order.

closed_err!(): proc_macro

A function-like macro to new a DceErr enum. Closed err means only print to console but not to response to client the specific error code and message.

Parameters:

• code isize:
  The error code, will be 0 if not specified.

• template &str:
  The error message or a template.

• args str-like[]:
  Template args.

open_err!(): proc_macro

A function-like macro to new a DceErr enum. Openly err means the specific error code and message will respond to client. Params same to closed_err!().

Macros

closed_err

openly_err

Attribute Macros

api