小编Cor*_*son的帖子

使用doxygen记录枚举值

鉴于:

namespace Foo {
    class Foo {
    public:
        /// Foo enum, possible ways to foo
        enum class Foo {
            /// Foo it with an A
            A,
            /// Foo it with a B
            B,
            /// Foo it with a C
            C
        }
    }
}
Run Code Online (Sandbox Code Playgroud)

和默认的Doxyfile doxygen -g,我得到这个:

生成的文档

如何记录枚举值?我尝试在成员之前/之后发表评论,使用///<等等都无济于事.可能这只是doxygen中的一个错误?文档中的示例有效.(点击枚举名称不会带我到任何地方)

c++ enums doxygen c++11

32
推荐指数
3
解决办法
5万
查看次数

HTTP 405 - Web服务器合规性

RFC规定:

10.4.6 405不允许的方法

请求行中指定的方法不允许由Request-URI标识的资源.响应必须包含一个Allow标头,其中包含所请求资源的有效方法列表.

但是,我一直无法确定一台符合MUST的服务器.

我可以看到,这一要求将是非常考虑到存在的各种代理,动态应用程序等,很难与现代的Web服务器来完成.

  1. 从历史上看,为什么这个要求有意义?
  2. 有什么依赖于这种行为,还是曾经做过?它的用例是什么?
  3. 不要任何网络服务器"正常"实现HTTP这方面?IIS(至少在使用ASP.NET时)甚至一些"RESTful"API在给出伪造方法时返回404而不是405,据我所知.

另外,为什么服务器返回405用于BOGUS等明显未由服务器实现的方法,即使在提供文档而不代理或调用某些代码(cgi/etc)时,它们应该返回501?

如果HTTP的这些部分被认为是"残留的",那么如果有任何服务器符合规范,那么这些部分是否很少?


实际上,大多数框架都没有那么难以正确地返回'允许'.我所知道的所有框架都需要指定将要调用特定控制器的方法(通常默认为GET),并且代码可以轻松地向框架注册扩展方法以便返回.

到目前为止,证据似乎指向a)没有人阅读规范,没有人知道这个要求,b)没有人关心这个功能.

rest http web-frameworks web

8
推荐指数
1
解决办法
6987
查看次数

标签 统计

c++ ×1

c++11 ×1

doxygen ×1

enums ×1

http ×1

rest ×1

web ×1

web-frameworks ×1