errs.go 17 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554
  1. package errs
  2. import (
  3. "fmt"
  4. "runtime"
  5. )
  6. type ErroNil *Error
  7. type Map map[string]interface{}
  8. type Error struct {
  9. HttpStatus int `json:"httpStatus"`
  10. CodeText string `json:"codetext"`
  11. Message string `json:"message"`
  12. Stack *ErrorStack `json:"stack,omitempty"`
  13. Errors []*Detail `json:"erros,omitempty"`
  14. }
  15. type Detail struct {
  16. Dominio string `json:"dominio,omitempty"`
  17. Reason string `json:"reason,omitempty"`
  18. Message string `json:"message,omitempty"`
  19. LocationType string `json:"locationType,omitempty"`
  20. Location string `json:"location,omitempty"`
  21. }
  22. type ErrorMapFunction func(error) (err *Error)
  23. // type ErrorMapFunction func(error) (err error, replaced bool)
  24. var (
  25. errorMapFunction = map[string]ErrorMapFunction{}
  26. )
  27. func RegisterMapErrorFunction(id string, fn ErrorMapFunction) {
  28. errorMapFunction[id] = fn
  29. }
  30. // Adiciona uma descricao ao erro
  31. // func (e *Erro) Add(desc *Detail) *Erro {
  32. // e.Errors = append(e.Errors, desc)
  33. // return e
  34. // }
  35. func (e *Error) Details(desc *Detail) *Error {
  36. e.Errors = append(e.Errors, desc)
  37. if len(e.Errors) == 1 {
  38. e.Message = desc.Message
  39. }
  40. return e
  41. }
  42. // Retorna a ultima descricao adicionada
  43. func (e *Error) LastDescription() *Detail {
  44. size := len(e.Errors)
  45. if size > 0 {
  46. return e.Errors[size-1]
  47. }
  48. return nil
  49. }
  50. // Error retorna a mensagem de erro principal
  51. func (e *Error) Error() string {
  52. return e.Message
  53. }
  54. // The operation was cancelled, typically by the caller.
  55. //
  56. // HTTP Mapping: 499 Client Closed Request
  57. func Cancelled() *Error {
  58. return errorHandler(&Error{
  59. HttpStatus: 499,
  60. CodeText: "client_closed_request",
  61. Message: `Solicitação cancelada pelo cliente.`,
  62. })
  63. }
  64. // Unknown error. For example, this error may be returned when
  65. // a `Status` value received from another address space belongs to
  66. // an error space that is not known in this address space. Also
  67. // errors raised by APIs that do not return enough error information
  68. // may be converted to this error.
  69. //
  70. // HTTP Mapping: 500 Internal Server Error
  71. func Unknown() *Error {
  72. return errorHandler(&Error{
  73. HttpStatus: 500,
  74. CodeText: "internal_server_error",
  75. Message: "",
  76. })
  77. }
  78. // The client specified an invalid argument. Note that this differs
  79. // from `FAILED_PRECONDITION`. `INVALID_ARGUMENT` indicates arguments
  80. // that are problematic regardless of the state of the system
  81. // (e.g., a malformed file name).
  82. //
  83. // HTTP Mapping: 400 Bad Request
  84. func InvalidArgument() *Error {
  85. return errorHandler(&Error{
  86. HttpStatus: 400,
  87. CodeText: "bad_request",
  88. Message: "O campo de solicitação xyz é xxx, mas o esperado é [yyy, zzz].",
  89. })
  90. }
  91. // The deadline expired before the operation could complete. For operations
  92. // that change the state of the system, this error may be returned
  93. // even if the operation has completed successfully. For example, a
  94. // successful response from a server could have been delayed long
  95. // enough for the deadline to expire.
  96. //
  97. // HTTP Mapping: 504 Gateway Timeout
  98. func DeadlineExceeded() *Error {
  99. return errorHandler(&Error{
  100. HttpStatus: 504,
  101. CodeText: "gateway_timeout",
  102. Message: "",
  103. })
  104. }
  105. // Some requested entity (e.g., file or directory) was not found.
  106. //
  107. // Note to server developers: if a request is denied for an entire class
  108. // of users, such as gradual feature rollout or undocumented whitelist,
  109. // `NOT_FOUND` may be used. If a request is denied for some users within
  110. // a class of users, such as user-based access control, `PERMISSION_DENIED`
  111. // must be used.
  112. //
  113. // HTTP Mapping: 404 Not Found
  114. func NotFound() *Error {
  115. return errorHandler(&Error{
  116. HttpStatus: 404,
  117. CodeText: "not_found",
  118. Message: `O recurso "xxx" não foi encontrado.`,
  119. })
  120. }
  121. // The entity that a client attempted to create (e.g., file or directory)
  122. // already exists.
  123. //
  124. // HTTP Mapping: 409 Conflict
  125. func AlreadyExists() *Error {
  126. return errorHandler(&Error{
  127. HttpStatus: 409,
  128. CodeText: "conflict",
  129. Message: `O recurso já existe.`,
  130. })
  131. }
  132. // The caller does not have permission to execute the specified
  133. // operation. `PERMISSION_DENIED` must not be used for rejections
  134. // caused by exhausting some resource (use `RESOURCE_EXHAUSTED`
  135. // instead for those errors). `PERMISSION_DENIED` must not be
  136. // used if the caller can not be identified (use `UNAUTHENTICATED`
  137. // instead for those errors). This error code does not imply the
  138. // request is valid or the requested entity exists or satisfies
  139. // other pre-conditions.
  140. //
  141. // HTTP Mapping: 403 Forbidden
  142. func PermissionDenied() *Error {
  143. return errorHandler(&Error{
  144. HttpStatus: 403,
  145. CodeText: "forbidden",
  146. Message: `Permissão "xxx" negada no arquivo "yyy".`,
  147. })
  148. }
  149. // The request does not have valid authentication credentials for the
  150. // operation.
  151. //
  152. // HTTP Mapping: 401 Unauthorized
  153. func Unauthenticated() *Error {
  154. return errorHandler(&Error{
  155. HttpStatus: 401,
  156. CodeText: "unauthorized",
  157. Message: `Credenciais de autenticação inválidas.`,
  158. })
  159. }
  160. // Some resource has been exhausted, perhaps a per-user quota, or
  161. // perhaps the entire file system is out of space.
  162. //
  163. // HTTP Mapping: 429 Too Many Requests
  164. func ResourceExhausted() *Error {
  165. return errorHandler(&Error{
  166. HttpStatus: 429,
  167. CodeText: "too_many_requests",
  168. Message: `Limite de cota "xxx" excedido.`,
  169. })
  170. }
  171. // The operation was rejected because the system is not in a state
  172. // required for the operation's execution. For example, the directory
  173. // to be deleted is non-empty, an rmdir operation is applied to
  174. // a non-directory, etc.
  175. //
  176. // Service implementors can use the following guidelines to decide
  177. // between `FAILED_PRECONDITION`, `ABORTED`, and `UNAVAILABLE`:
  178. // (a) Use `UNAVAILABLE` if the client can retry just the failing call.
  179. // (b) Use `ABORTED` if the client should retry at a higher level
  180. // (e.g., when a client-specified test-and-set fails, indicating the
  181. // client should restart a read-modify-write sequence).
  182. // (c) Use `FAILED_PRECONDITION` if the client should not retry until
  183. // the system state has been explicitly fixed. E.g., if an "rmdir"
  184. // fails because the directory is non-empty, `FAILED_PRECONDITION`
  185. // should be returned since the client should not retry unless
  186. // the files are deleted from the directory.
  187. //
  188. // HTTP Mapping: 400 Bad Request
  189. func FailedPrecondition() *Error {
  190. return errorHandler(&Error{
  191. HttpStatus: 400,
  192. CodeText: "bad_request",
  193. Message: `O recurso xxx é um diretório que não está vazio, portanto, não pode ser excluído.`,
  194. })
  195. }
  196. // The operation was aborted, typically due to a concurrency issue such as
  197. // a sequencer check failure or transaction abort.
  198. //
  199. // See the guidelines above for deciding between `FAILED_PRECONDITION`,
  200. // `ABORTED`, and `UNAVAILABLE`.
  201. //
  202. // HTTP Mapping: 409 Conflict
  203. func Aborted() *Error {
  204. return errorHandler(&Error{
  205. HttpStatus: 409,
  206. CodeText: "conflict",
  207. Message: `Não foi possível adquirir o bloqueio no recurso "xxx".`,
  208. })
  209. }
  210. // The operation was attempted past the valid range. E.g., seeking or
  211. // reading past end-of-file.
  212. //
  213. // Unlike `INVALID_ARGUMENT`, this error indicates a problem that may
  214. // be fixed if the system state changes. For example, a 32-bit file
  215. // system will generate `INVALID_ARGUMENT` if asked to read at an
  216. // offset that is not in the range [0,2^32-1], but it will generate
  217. // `OUT_OF_RANGE` if asked to read from an offset past the current
  218. // file size.
  219. //
  220. // There is a fair bit of overlap between `FAILED_PRECONDITION` and
  221. // `OUT_OF_RANGE`. We recommend using `OUT_OF_RANGE` (the more specific
  222. // error) when it applies so that callers who are iterating through
  223. // a space can easily look for an `OUT_OF_RANGE` error to detect when
  224. // they are done.
  225. //
  226. // HTTP Mapping: 400 Bad Request
  227. func OutOfRange() *Error {
  228. return errorHandler(&Error{
  229. HttpStatus: 400,
  230. CodeText: "bad_request",
  231. Message: `A "idade" do parâmetro está fora do intervalo [0, 125].`,
  232. })
  233. }
  234. func HTTPVersionNotSupported() *Error {
  235. return errorHandler(&Error{
  236. HttpStatus: 400,
  237. CodeText: "http_version_not_supported",
  238. Message: `The server doesn’t support the major HTTP version the client used to make the request.`,
  239. })
  240. }
  241. // The operation is not implemented or is not supported/enabled in this
  242. // service.
  243. //
  244. // HTTP Mapping: 501 Not Implemented
  245. func Unimplemented() *Error {
  246. return errorHandler(&Error{
  247. HttpStatus: 501,
  248. CodeText: "not_implemented",
  249. Message: `Método "xxx" não implementado.`,
  250. })
  251. }
  252. // Internal errors. This means that some invariants expected by the
  253. // underlying system have been broken. This error code is reserved
  254. // for serious errors.
  255. //
  256. // HTTP Mapping: 500 Internal Server Error
  257. func Internal() *Error {
  258. return errorHandler(&Error{
  259. HttpStatus: 500,
  260. CodeText: "internal_server_error",
  261. Message: `Error interno.`,
  262. })
  263. }
  264. // The service is currently unavailable. This is most likely a
  265. // transient condition, which can be corrected by retrying with
  266. // a backoff.
  267. //
  268. // See the guidelines above for deciding between `FAILED_PRECONDITION`,
  269. // `ABORTED`, and `UNAVAILABLE`.
  270. //
  271. // HTTP Mapping: 503 Service Unavailable
  272. func Unavaliable() *Error {
  273. return errorHandler(&Error{
  274. HttpStatus: 503,
  275. CodeText: "service_unavailable",
  276. Message: "Serviço indisponivel.",
  277. })
  278. }
  279. // Unrecoverable data loss or corruption.
  280. //
  281. // HTTP Mapping: 500 Internal Server Error
  282. func DataCaps() *Error {
  283. return errorHandler(&Error{
  284. HttpStatus: 500,
  285. CodeText: "internal_server_error",
  286. Message: `Error interno.`,
  287. })
  288. }
  289. func errorHandler(err *Error) *Error {
  290. err.Stack = Trace()
  291. return err
  292. }
  293. // }
  294. // func Error(code int, m string) *Error {
  295. // LogError(code, m)
  296. // e := ErrosList[code]
  297. // if m != "" {
  298. // e.Message = m
  299. // }
  300. // e.Details(&Detail{
  301. // Dominio: "global",
  302. // Message: m,
  303. // })
  304. // return &e
  305. // }
  306. // func FullError(code int, err *Detail) *Error {
  307. // // _, fn, line, _ := runtime.Caller(1
  308. // // LogError(code, fmt.Sprintf("%s:%d - %s", fn, line, err.Message))
  309. // e := ErrosList[code]
  310. // e.Message = err.Message
  311. // e.Stack = Trace()
  312. // e.Details(err)
  313. // return &e
  314. // }
  315. type ErrorStack struct {
  316. Frames []runtime.Frame
  317. }
  318. func (stack *ErrorStack) Print() {
  319. for _, f := range stack.Frames {
  320. fmt.Printf("%s\n\t%s:%d\n", f.Function, f.File, f.Line)
  321. }
  322. }
  323. func Trace() (stack *ErrorStack) {
  324. stack = &ErrorStack{}
  325. pc := make([]uintptr, 20)
  326. n := runtime.Callers(2, pc)
  327. if n == 0 {
  328. // No pcs available. Stop now.
  329. // This can happen if the first argument to runtime.Callers is large.
  330. return
  331. }
  332. pc = pc[:n] // pass only valid pcs to runtime.CallersFrames
  333. frames := runtime.CallersFrames(pc)
  334. // Loop to get frames.
  335. // A fixed number of pcs can expand to an indefinite number of Frames.
  336. for {
  337. frame, more := frames.Next()
  338. stack.Frames = append(stack.Frames, frame)
  339. // To keep this example's output stable
  340. // even if there are changes in the testing package,
  341. // stop unwinding when we leave package runtime.
  342. // if strings.Contains(frame.Function, "main.main") {
  343. // break
  344. // }
  345. // spew.Dump(frame)
  346. if !more {
  347. break
  348. }
  349. }
  350. return
  351. }
  352. func FromError(source error) (err *Error) {
  353. for _, fn := range errorMapFunction {
  354. if err = fn(source); err != nil {
  355. return
  356. }
  357. }
  358. err = Internal().Details(&Detail{
  359. Message: source.Error(),
  360. })
  361. return
  362. }
  363. // 400 invalidParameter Indica que um parâmetro de solicitação tem um valor inválido. Os campos locationType e location na resposta de erro fornecem informações sobre qual valor era inválido. Não tente novamente sem corrigir o problema. Você precisa fornecer um valor válido para o parâmetro especificado na resposta de erro.
  364. // 400 badRequest Indica que a consulta era inválida. Por exemplo, o ID pai estava ausente ou a combinação de dimensões ou métricas solicitada não era válida. Não tente novamente sem corrigir o problema. Você precisa fazer alterações na consulta da API para que ela funcione.
  365. // 401 invalidCredentials Indica que o token de autenticação é inválido ou expirou. Não tente novamente sem corrigir o problema. Você precisa receber um novo token de autenticação.
  366. // 403 insufficientPermissions Indica que o usuário não tem permissões suficientes para a entidade especificada na consulta. Não tente novamente sem corrigir o problema. Você precisa receber permissões suficientes para executar a operação na entidade especificada.
  367. // 403 dailyLimitExceeded Indica que o usuário ultrapassou a cota diária [por projeto ou vista da propriedade (perfil)]. Não tente novamente sem corrigir o problema. Você esgotou sua cota diária. Consulte Limites e cotas da API.
  368. // 403 usageLimits.userRateLimitExceededUnreg Indica que o aplicativo precisa ser registrado no console de APIs do Google. Não tente novamente sem corrigir o problema. Você precisa se registrar no console de APIs para receber a cota completa da API.
  369. // 403 userRateLimitExceeded Indica que o limite da taxa de usuário foi ultrapassado. O limite de taxa máximo é de 10 qps por endereço IP. O valor padrão definido no console de APIs do Google é 1 qps por endereço IP. Você pode aumentar esse limite no console de APIs do Google para no máximo 10 qps. Tente novamente usando backoff exponencial. Você precisa diminuir a taxa em que envia as solicitações.
  370. // 403 rateLimitExceeded Indica que os limites de taxa global ou geral do projeto foram excedidos. Tente novamente usando backoff exponencial. Você precisa diminuir a taxa em que envia as solicitações.
  371. // 403 quotaExceeded Indica que o limite de 10 solicitações simultâneas por vista da propriedade (perfil) na API de relatórios principais foi atingido. Tente novamente usando backoff exponencial. Você precisa aguardar até que pelo menos uma solicitação em andamento para essa Vista (perfil) seja concluída.
  372. // ERR_BAD_REQUEST: Erro{
  373. // HttpStatus: 400,
  374. // CodeText: "bad_request",
  375. // Message: "",
  376. // },
  377. // ERR_INVALID_PARAM: Erro{
  378. // HttpStatus: 400,
  379. // CodeText: "invalid_param",
  380. // Message: "",
  381. // },
  382. // ERR_INVALID_PARAM_VALUE: Erro{
  383. // HttpStatus: 400,
  384. // CodeText: "invalid_param_value",
  385. // Message: "",
  386. // },
  387. // ERR_INVALID_CREDENTIAL: Erro{
  388. // HttpStatus: 401,
  389. // CodeText: "invalid_credential",
  390. // Message: "Invalid Credentials",
  391. // },
  392. // ERR_NOT_FOUND: Erro{
  393. // HttpStatus: 404,
  394. // CodeText: "not_found",
  395. // Message: "Recurso não existe",
  396. // },
  397. // ERR_PERSIST: Erro{
  398. // HttpStatus: 500,
  399. // CodeText: "persist_error",
  400. // Message: "Não foi possivel salvar as alterações",
  401. // },
  402. // ERR_CONFLICT: Erro{
  403. // HttpStatus: 409,
  404. // CodeText: "conflict",
  405. // Message: "A operação falhou porque o item é referenciado por outras.",
  406. // },
  407. // ERR_GENERAL: Erro{
  408. // HttpStatus: 500,
  409. // CodeText: "general",
  410. // Message: "Parece que algo deu errado. Nós pedimos desculpas. Você pode voltar para a página principal",
  411. // },
  412. // ERR_EXPIRED: Erro{
  413. // HttpStatus: 500,
  414. // CodeText: "expired",
  415. // Message: "Parece que o recurso não esta mais disponível",
  416. // },
  417. // const (
  418. // ERR_NOT_FOUND int = iota
  419. // ERR_GENERAL
  420. // ERR_PERSIST
  421. // ERR_INVALID_CREDENTIAL
  422. // ERR_BAD_REQUEST
  423. // ERR_INVALID_PARAM
  424. // ERR_INVALID_PARAM_VALUE
  425. // ERR_EXPIRED
  426. // ERR_NOT_MODIFIED
  427. // ERR_TEMPORARY_REDIRECT
  428. // ERR_UNAUTHORIZED
  429. // ERR_PAYMENT_REQUIRED
  430. // ERR_FORBIDDEN
  431. // ERR_METHOD_NOT_ALLOWED
  432. // ERR_CONFLICT
  433. // ERR_TOO_MANY_REQUESTS
  434. // ERR_NOT_IMPLEMENTED
  435. // ERR_SERVICE_UNAVAILABLE
  436. // )
  437. // Error cria uma instancia de um erro
  438. // code int assume:
  439. // ERR_NOT_FOUND int = 0
  440. // ERR_GENERAL int = 1
  441. // ERR_PERSIST int = 2
  442. // ERR_INVALID_CREDENTIAL int = 3
  443. // ERR_BAD_REQUEST int = 4
  444. // ERR_INVALID_PARAM int = 5
  445. // ERR_EXPIRED int = 6
  446. // func Errorf(code int, m string, args ...interface{}) *Erro {
  447. // LogError(code, m)
  448. // m = fmt.Sprintf(m, args...)
  449. // e := ErrosList[code]
  450. // if m != "" {
  451. // e.Message = m
  452. // }
  453. // e.Add(&Detail{
  454. // Dominio: "global",
  455. // Message: m,
  456. // })
  457. // return &e
  458. // }
  459. // func Falha(ctx context.Context, code int, m string, dev Map) {
  460. // // fmt.Println("CodeText:[", code, "]", m, dev);
  461. // // ctx.StopExecution()
  462. // base := ErrosList[code]
  463. // base.Development = Map{}
  464. // if m != "" {
  465. // base.Message = m
  466. // }
  467. // if dev != nil {
  468. // base.Development = dev
  469. // }
  470. // accept := ctx.GetHeader("Accept")
  471. // ctx.StatusCode(base.Code)
  472. // //spew.Dump(base)
  473. // if base.Error == "not_found" {
  474. // url := ctx.Host() + ctx.RequestPath(true)
  475. // base.Development["url"] = fmt.Sprintf("A url '%s' não foi encontrada.", url)
  476. // }
  477. // if accept == "application/json" {
  478. // ctx.JSON(base)
  479. // } else {
  480. // ctx.ViewData("", base)
  481. // // ctx.View(ViewScript(ctx, "error.html"))
  482. // }
  483. // ctx.StopExecution()
  484. // }