jjzjj

day01-2-@RequestMapping和Rest

liyuelian 2023-04-19 原文

@RequestMapping和Rest

1.@RequestMapping

1.1基本使用

@RequestMapping注解可以指定 控制器(处理器) 的某个方法的请求url

1.2@RequestMapping其他使用方式

1.2.1修饰方法和类

@RequestMapping注解可以修饰方法,还可以修饰类。

当同时修饰类和方法时,请求的url就是组合形式:/类请求值/方法请求值

例子

(1)UserHandler.java:

package com.li.web;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;

/**
 * @author 李
 * @version 1.0
 */
@RequestMapping(value = "/user")
@Controller  //UserHandler就是一个处理器/控制器,注入到spring容器
public class UserHandler {
    /**
     * 1.method = RequestMethod.POST 表示请求buy方法必须是post请求
     * 2.RequestMethod 四个常用的选项 :GET, POST, PUT, DELETE
     * 3.如果没有配置 RequestMethod,SpringMVC控制器默认支持 get和 post两种方式
     * 4.buy()方法对应的完整请求url = http://ip:port/web工程路径/user/buy
     * @return
     */
    @RequestMapping(value = "/buy", method = RequestMethod.POST)
    public String buy() {
        System.out.println("购买商品");
        return "success";
    }
}

(2)request.jsp:

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>购买商品</title>
</head>
<body>
<h1>购买商品</h1>
<%--
buy()方法对应的完整请求 url = http://ip:port/web工程路径/user/buy
--%>
<form action="user/buy" method="post">
    购买人:<input type="text" name="username"/><br/>
    购买量:<input type="text" name="nums"/><br/>
    <input type="submit" value="提交"/>
</form>
</body>
</html>

(3)success.jsp:

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>操作成功</title>
</head>
<body>
<h1>恭喜,操作成功!</h1>
</body>
</html>

在浏览器中访问 http://localhost:8080/springmvc/request.jsp,点击提交按钮,结果如下:

1.2.2指定请求方式

  1. @RequestMapping 可以指定请求的方式(post/get/put/delete...),请求方式要和指定方式一致,否则报错:

  2. SpringMVC 控制器默认支持get 和 post两种请求方式,即如果没有指定 method,可以接收 get 和 post请求

1.2.3指定params和headers,支持简单表达式

  1. param1:表示请求必须包含名为 param1 的请求参数
  2. !param1:表示请求不能包含名为 param1 的请求参数
  3. param1 != value1:表示请求包含名为 param1 的请求参数,但其值不能为 value1
  4. {"param1 = value1", "param2"}:请求必须包含名为 param1 和 param2 的两个请求参数,且 param1的值必须为 value1

应用实例

(1)修改UserHandler.java,增加方法

//...
@RequestMapping(value = "/user")
@Controller  
public class UserHandler {
    //...

    /**
     * 1.params = "bookId" 表示请求该方式时,必须给一个名为 bookId的参数
     * 2.search(String bookId){} 表示请求目标方法时,
     *  携带的 bookId参数的值会被填充到目标方法的同名形参中
     * @param bookId
     * @return
     */
    @RequestMapping(value = "/find", params = "bookId", method = RequestMethod.GET)
    public String search(String bookId) {
        System.out.println("查询书籍 bookId=" + bookId);
        return "success";
    }
}

(2)request.jsp

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>购买商品</title>
</head>
<body>
<h1>演示params的使用</h1>
<a href="user/find?bookId=100">查询书籍</a>
</body>
</html>

(3) success.jsp 不变。

(4)redeployTomcat,在浏览器地址栏访问:http://localhost:8080/springmvc/request.jsp,点击查询书籍超链接,结果如下:

(5)修改UserHandler.java,指定参数的值=100。

(6)修改request.jsp,修改发送的值为200.

(7)redeployTomcat,重新范文request.jsp,点击超链接,这里可以看到出现异常,因为发送的值和方法指定的值不一样。

1.2.4支持Ant 风格资源地址

  1. ?:匹配文件名中的一个字符
  2. *:匹配文件名中的任意字符,长度任意
  3. **:匹配多层路径
  4. Ant 风格的 url 地址举例:
    • /user/*/createUser:匹配 /user/aaa/createUser、/user/bbb/createUser 等 URL
    • /user/**/createUser:匹配 /user/createUser、/user/aaa/bbb/createUser 等 URL
    • /user/createUser??: 匹配 /user/createUserab、/user/createUsercd 等 URL

应用实例

(1)修改UserHandler.java,增加方法:

//...
@RequestMapping(value = "/user")
@Controller  
public class UserHandler {
    //...
    
    /**
     * 要求:可以匹配 /user/message/aa, /user/message/aa/bb/cc
     *  @RequestMapping(value = "/message/**")
     *  表示可以匹配多层的路径
     * @return
     */
    @RequestMapping(value = "/message/**")
    public String im(){
        System.out.println("发送消息");
        return "success";
    }
}

(2)修改request.jsp

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>购买商品</title>
</head>
<body>
<h1>演示 Ant 风格的请求资源方式</h1>
<a href="user/message/aa">发送消息 1</a><br>
<a href="user/message/aa/bb/cc">发送消息 2</a><br>
</body>
</html>

(3) success.jsp 不变。

(4)redeployTomcat,在浏览器地址栏访问:http://localhost:8080/springmvc/request.jsp,分别点击两个超链接,都能成功访问方法,并跳转到success.jsp

1.2.5可配合@PathVariable映射URL绑定的占位符

  1. @RequestMapping 还可以配合 @PathVariable(路径变量) 映射 URL 绑定的占位符
  2. 这样就不需要在url地址栏上带参数名了,更加简洁明了

例子

request.jsp页面如下,其中 kristina 和 300 皆为参数值

<h1>占位符的演示</h1>
<a href="user/reg/kristina/300">占位符的演示</a>

(1)修改UserHandler.java,增加方法,注意@PathVariable("username") 不能少

//...
@RequestMapping(value = "/user")
@Controller 
public class UserHandler {
    /**
     * 我们希望目标方法获取到username和 userid
     * 前端页面为:<a href="user/reg/kristina/300">占位符的演示</a>
     * 1. value = "/reg/{username}/{userid}"
     *    表示 kristina=>{username} ,300=>{userid}
     * 2.通过 @PathVariable 将变量赋给对应的形参
     */
    @RequestMapping(value = "/reg/{username}/{userid}")
    public String register(@PathVariable("username") String name,
                           @PathVariable("userid") int id) {
        System.out.println("接收到的参数--username=" + name + "--userid=" + id);
        return "success";
    }
}

(2)success.jsp不变

(3)redeployTomcat,访问 http://localhost:8080/springmvc/request.jsp,点击超链接,成功访问到success.jsp,后台输出如下:

1.2.6注意事项和使用细节

  1. 映射的URL不能重复,否则报错:

    注意:Spring MVC controller路径是否能够重复?

    Caused by: java.lang.IllegalStateException: Ambiguous mapping. Cannot map 'userHandler' method 
    com.li.web.UserHandler#buy()
    to {POST [/user/buy]}: There is already 'userHandler' bean method
    
  2. 各种请求的简写形式

    @RequestMapping(value="/buy",method=RequestMethod.POST) 等价于 @PostMapping(value="buy")

    以此类推,还有 @GetMapping@PostMapping@PutMapping@DeleteMapping

  3. 如果我们确定表单或者超链接会提交某个字段数据,比如email,要求提交的参数名和目标方法的参数名保持一致。

    例如:

    /**
     * hello3(String email){} 如果请求参数有email=xx,就会将传递的参数值赋给String email
     * 但是要求名称保持一致!如果不一致,那么接收不到数据,而是null
     * @param email
     * @return
     */
    @GetMapping(value = "/hello3")
    public String hello3(String email) {
        System.out.println("hello3= " + email);
        return "success";
    }
    

1.2.7练习

编写一个表单,以Post方式提交表单信息,后端编写ComputerHandler,可以接收到表单信息

computer.jsp:

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>hw-电脑信息</title>
</head>
<body>
<h1>电脑信息</h1>
<form action="computer/info" method="post">
    品牌:<input type="text" name="brand"/><br/>
    价格:<input type="text" name="price"/><br/>
    数量:<input type="text" name="nums"/><br/>
    <input type="submit" value="提交">
</form>
</body>
</html>

ComputerHandler:

package com.li.web;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestMapping;

/**
 * @author 李
 * @version 1.0
 */
@RequestMapping("/computer")
@Controller
public class ComputerHandler {
    //注意接收的参数名要和info方法的形参名一致
    @PostMapping("/info")
    public String info(String brand, String price, String nums) {
        System.out.println("brand=" + brand +
                " price=" + price + " nums=" + nums);
        return "success";
    }
}

redeployTomcat,访问:http://localhost:8080/springmvc/computer.jsp,输入信息,点击提交表单。

后台输出:

1.3Postman接口测试工具

1.3.1Postman介绍

具体安装步骤

(1)下载Postman软件

(2)安装

  1. 右键安装包,选择用管理员身份运行。Postman不会让你选择安装路径,会直接安装,一般安装在系统盘

  2. 安装成功后,桌面上会出现快捷图标

1.3.2Postman快速入门

快速入门需求说明:使用 Postman向 http://www.baidu.com 发出 get请求,得到返回的 html格式数据

快速入门-实现步骤

  1. 进入Postman,默认界面如下:

  2. 创建Http Request,如果你已经创建过,会直接进入Workspace

  3. 在新页面输入要测试的 url,点击save

  4. 在弹出的新窗口中点击Create a collection

  5. 在弹出的新窗口中填入collection名称,点击create,然后点击save

  6. 配置完毕的界面

  7. 点击Send按钮,即可向目标url发送请求,获取返回数据

1.3.3Postman完成Controller层测试

(1)测试用例1

使用Postman,完成对之前编写的UserHandler方法的请求测试

@RequestMapping(value = "/user")
@Controller  //UserHandler就是一个处理器/控制器,注入到spring容器
public class UserHandler {
	@RequestMapping(value = "/find", params = "bookId=100", method = RequestMethod.GET)
    public String search(String bookId) {
        System.out.println("查询书籍 bookId=" + bookId);
        return "success";
    }
}

测试

  1. 确定请求地址url:http://localhost:8080/springmvc/user/find
  2. 使用请求的方式:Get
  3. 确定请求的参数/数据:bookId=100
  4. 确定 Header有没有特殊的指定:无

点击Send,返回数据,测试成功。

(2)测试用例2

@RequestMapping(value = "/user")
@Controller  //UserHandler就是一个处理器/控制器,注入到spring容器
public class UserHandler {
    @RequestMapping(value = "/message/**")
    public String im() {
        System.out.println("发送消息");
        return "success";
    }
}

测试

  1. 确定请求地址url:http://localhost:8080/springmvc/user/message/aa/bb/cc
  2. 使用请求的方式:Get 或者 Post
  3. 确定请求的参数/数据:无
  4. 确定 Header有没有特殊的指定:无

点击Send,返回数据,测试成功。

(3)测试用例3

@RequestMapping(value = "/user")
@Controller  //UserHandler就是一个处理器/控制器,注入到spring容器
public class UserHandler {
    @RequestMapping(value = "/reg/{username}/{userid}")
    public String register(@PathVariable("username") String name,
                           @PathVariable("userid") int id) {
        System.out.println("接收到的参数--username=" + name + "--userid=" + id);
        return "success";
    }
}

测试

  1. 确定请求地址url:http://localhost:8080/springmvc/user/reg/jack/1000
  2. 使用请求的方式:Get 或者 Post
  3. 确定请求的参数/数据:无
  4. 确定 Header有没有特殊的指定:无

点击Send,返回数据,测试成功。

关于Postman的其他使用,在讲解框架和项目时,再具体演示

2.REST-优雅的url请求风格

2.1REST基本介绍

REST风格详细介绍

  1. REST:即 Representational State Transfer,表述性状态传递。它结构清晰,同时可以隐藏行为。

  2. 通过一个url来直观展示传统风格与REST风格的区别:

    • 传统风格:
      当我们在浏览器上访问一些资源时,可以看到有些网页的url为

      http://localhost/students/selectById?id=1 (该地址表示查找id为1的students对象)

      http://localhost/students/saveStudent(该地址表示保存students信息)

    • REST风格:
      http://localhosts/student/1

      http://localhosts/student

    通过这两种风格的对比,我们可以看到REST风格的一部分优点:

    (1)可以隐藏资源访问行为(如隐藏了selectById等),这样就无法通过地址得知对资源进行了哪种操作

    (2)可以明显的看到其书写简化了,不仅书写简化了,在开发时代码也可以简化。

  3. HTTP 协议里,四个表示操作方式的动词:GET,POST,PUT,DELETE。它们分别对应四种基本操作:GET用来获取资源,POST用来新建资源,PUT用来更新资源,DELETE用来删除资源。

  4. 传统的url通过参数说明 crud的类型,而rest则是通过 get/post/put/delete 来说明 crud的类型

  • REST的核心过滤器
    1. 当前的浏览器只支持 post/get 请求,因此为了得到 put/delete 的请求方式,需要使用 Spring 提供的HiddenHttpMethodFilter 过滤器进行转换。
    2. HiddenHttpMethodFilter :浏览器form表单只支持GET 和 POST请求,而DELETE、PUT 等method并不支持,Spring 添加了一个过滤器,可以将这些请求转换为标准的http方法,使得支持这四种请求方式。
    3. 需要特别注意:HiddenHttpMethodFilter 只能对 post请求方式进行转换
    4. 这个过滤器需要在web.xml中配置

2.2Rest风格的url-完成crud操作

2.2.1需求说明

2.2.2代码实现

  1. 修改web.xml添加 HiddenHttpMethodFilter过滤器,它的作用是将post请求转换为指定的delete或put请求

    <!--配置HiddenHttpMethodFilter过滤器
        1.它的作用是将以post方式提交的delete请求和put请求进行转换
        2.配置url-pattern为/*,表示所有请求都经过hiddenHttpMethodFilter过滤
        -->
    <filter>
        <filter-name>hiddenHttpMethodFilter</filter-name>
        <filter-class>org.springframework.web.filter.HiddenHttpMethodFilter</filter-class>
    </filter>
    <filter-mapping>
        <filter-name>hiddenHttpMethodFilter</filter-name>
        <url-pattern>/*</url-pattern>
    </filter-mapping>
    
  2. 在SpringDispatcherServlet-servlet.xml添加两个常规的配置

    <!--加入两个常规的配置-->
    <!--支持SpringMVC的高级功能,比如:JSR303校验,映射动态请求-->
    <mvc:annotation-driven></mvc:annotation-driven>
    <!--将SpringMVC不能处理的请求,交给tomcat处理,比如css,js-->
    <mvc:default-servlet-handler/>
    

    注意:mvc:annotion添加的是后缀为mvc的命名空间:

  3. 创建rest.jsp

    Idea中导入jquery无法生效的解决方法

    <%@ page contentType="text/html;charset=UTF-8" language="java" %>
    <html>
    <head>
        <title>rest</title>
        <script type="text/javascript" src="script/jquery-3.6.0.min.js"></script>
        <script type="text/javascript">
            $(function () {
                $("#deleteBook").click(function () {
                    //将当前的超链接的href的值,赋给hiddenForm表单的action属性
                    $("#hiddenForm").attr("action", this.href);
                    $(":hidden").val("DELETE");//给hidden的_method参数赋值为delete
                    $("#hiddenForm").submit();//提交表单
                    return false;//改变超链接行为,不再提交
                })
    
                //与上同理,不一样的是这里原本就是表单post请求
                $("#updateBook").click(function () {
                    //带上目标请求格式,HiddenHttpMethodFilter会自动将post请求转成你指定的格式
                    $(":hidden").val("PUT");//给hidden的_method参数赋值为put
                })
            })
        </script>
    </head>
    <body>
    <h2>Rest风格的crud操作案例</h2>
    <hr/>
    
    <h3>rest风格的url 查询书籍[get]</h3>
    <a href="user/book/200">点击查询书籍</a>
    <hr/>
    
    <h3>rest风格的url 添加书籍[post]</h3>
    <form action="user/book" method="post">
        name:<input name="bookName" type="text"/><br/>
        <input type="submit" value="添加书籍"/>
    </form>
    <hr/>
    
    <h3>rest风格的url 删除书籍[delete]</h3>
    <%--说明:
    1.在默认情况下,超链接是get请求
    2.要将get请求转成SpringMVC可以识别的delete,就要考虑HiddenHttpMethodFilter机制:
       public static final String DEFAULT_METHOD_PARAM = "_method";
       -------------------------------------
       private static final List<String> ALLOWED_METHODS =
          Collections.unmodifiableList(Arrays.asList(HttpMethod.PUT.name(),
              HttpMethod.DELETE.name(), HttpMethod.PATCH.name()));
       -------------------------------------
       //获取请求的方式,如果是post方式,就进行处理
       if ("POST".equals(request.getMethod()) && request.getAttribute(WebUtils.ERROR_EXCEPTION_ATTRIBUTE) == null) {
             String paramValue = request.getParameter(this.methodParam);
             if (StringUtils.hasLength(paramValue)) {
                String method = paramValue.toUpperCase(Locale.ENGLISH);
                if (ALLOWED_METHODS.contains(method)) {//若指定method在ALLOWED_METHODS中存在
                   //进行包装,转换为springmvc可以解析的请求
                    requestToUse = new HttpMethodRequestWrapper(request, method);
                }
             }
          }
       --------------------------------------
    3.从上述代码可以看到,HiddenHttpMethodFilter 过滤器可以对以
        Post方式提交的delete,put,patch转换成springmvc识别的RequestMethod.DElETE,RequestMethod.PUT...
    4.但是当前的超链接为 get请求,怎么将get请求转换成 post的请求方式呢?
    5.我们可以使用jquery来进行处理,让用户点击超链接的时候,走一个表单的请求
    --%>
    <a href="user/book/600" id="deleteBook">删除指定id的书籍</a>
    <form action="" method="post" id="hiddenForm">
        <input type="hidden" name="_method"/>
    </form>
    <hr/>
    
    <h3>rest风格的url 修改书籍[put]</h3>
    <form action="user/book/666" method="post" id="updateBook">
        <input type="hidden" name="_method">
        <input type="submit" value="修改书籍"/>
    </form>
    </body>
    </html>
    
  4. BookHandle.java

    1. 下面的代码中可以看到,许多方法的REST风格匹配的url是一样的,但是由于它们的请求方式不同,所以匹配到的方法不同。这也是rest风格的优点:不仅简化了url,而且隐藏了行为。
    2. 所以实际上SpringMVC的Controller层的url是可以相同的,会另外根据请求方式的不同来匹配方法
    package com.li.web.rest;
    
    import org.springframework.stereotype.Controller;
    import org.springframework.web.bind.annotation.*;
    
    /**
     * @author 李
     * @version 1.0
     * 用于处理rest风格的请求-crud
     */
    @RequestMapping(value = "/user")
    @Controller
    public class bookHandler {
        //查询[get]
        @RequestMapping(value = "/book/{id}", method = RequestMethod.GET)
        public String getBook(@PathVariable("id") String id) {
            System.out.println("查询书籍 id=" + id);
            return "success";
        }
    
        //添加[post]
        @PostMapping(value = "/book")
        public String addBook(String bookName) {//注意参数名字要和表单提交的参数名称一致
            System.out.println("添加书籍 bookName=" + bookName);
            return "success";
        }
    
        //删除[delete]
        @DeleteMapping(value = "/book/{id}")
        public String delBook(@PathVariable("id") String id) {
            System.out.println("删除书籍 id=" + id);
            //return "success";//这样写,返回会报错:HTTP Status 405 - JSPs only permit GET POST or HEAD
            //redirect:/user/success 重定向,会被解析成 /web工程路径/user/success,然后返回给浏览器解析
            return "redirect:/user/success";//重定向到一个没有指定method的 Handler方法
        }
    
        //如果请求是 /user/success,就转发到success.jsp
        @RequestMapping(value = "/success")
        public String successGeneral() {
            return "success";//该方法转发到success.jsp页面
        }
    
        @PutMapping(value = "/book/{id}")
        public String updateBook(@PathVariable("id") String id) {
            System.out.println("修改书籍 id=" + id);
            return "redirect:/user/success";//同理
        }
    }
    
  5. success.jsp

    <%@ page contentType="text/html;charset=UTF-8" language="java" %>
    <html>
    <head>
        <title>操作成功</title>
    </head>
    <body>
    <h1>恭喜,操作成功!</h1>
    </body>
    </html>
    
  6. 测试,redeployTomcat,访问:http://localhost:8080/springmvc/rest.jsp,在分别点击四种提交方式,前端页面和后台输出如下:

2.2.3注意事项和使用细节

  1. HiddenHttpMethodFilter在将 post请求转成 delete/put请求时,是按照 _method 参数名来读取的

  2. 如果web项目是运行在 Tomcat8及以上,会发现被过滤成 DELETE和 PUT请求后,到达控制器Controller时能顺利执行,但是返回(forward)会报HTTP 405 提示:HTTP Status 405 - JSPs only permit GET POST or HEAD。意为JSP只允许GET POST 或 HEAD

    (1)解决方式1:使用Tomcat7

    (2)解决方式2:将请求转发(forward)改为重定向(redirect),重定向到一个Handler,由Handler转发到页面。

  3. 页面测试时,如果出现点击修改书籍,仍然走的是删除url,可能是浏览器缓存等原因,换成Chrome即可。如果再不行,使用js修改表单的hidden的_method的值

有关day01-2-@RequestMapping和Rest的更多相关文章

  1. ruby-on-rails - rails : Find tasks that were created on a certain day? - 2

    我有一个任务列表(名称、starts_at),我试图在每日View中显示它们(就像iCal)。deftodays_tasks(day)Task.find(:all,:conditions=>["starts_atbetween?and?",day.beginning,day.ending]end我不知道如何将Time.now(例如“2009-04-1210:00:00”)动态转换为一天的开始(和结束),以便进行比较。 最佳答案 deftodays_tasks(now=Time.now)Task.find(:all,:conditio

  2. 什么是0day漏洞?如何预防0day攻击? - 2

    什么是0day漏洞?0day漏洞,是指已经被发现,但是还未被公开,同时官方还没有相关补丁的漏洞;通俗的讲,就是除了黑客,没人知道他的存在,其往往具有很大的突发性、破坏性、致命性。0day漏洞之所以称为0day,正是因为其补丁永远晚于攻击。所以攻击者利用0day漏洞攻击的成功率极高,往往可以达到目的并全身而退,而防守方却一无所知,只有在漏洞公布之后,才后知后觉,却为时已晚。“后知后觉、反应迟钝”就是当前安全防护面对0day攻击的真实写照!为了方便大家理解,中科三方为大家梳理当前安全防护模式下,一个漏洞从发现到解决的三个时间节点:T0:此时漏洞即0day漏洞,是已经被发现,还未被公开,官方还没有相

  3. ruby - Rails 比较 date.end_of_day.to_datetime 和 date.to_datetime.end_of_day 返回的日期对象值时返回 false - 2

    ruby1.9.3dev(2011-09-23修订版33323)[i686-linux]轨道3.0.20最近为什么在与DateTimeonRails相关的RSpecs项目上工作我发现在给定日期以下语句发出的值date.end_of_day.to_datetime和date.to_datetime.end_of_day虽然它们表示相同的日期时间,但比较时返回false。为了确认这一点,我打开了Rails控制台并尝试了以下操作1.9.3dev:053>monday=Time.now.monday=>2013-02-2500:00:00+05301.9.3dev:054>monday.cla

  4. ruby - Sinatra REST API 应用程序的身份验证 - 2

    我正在使用Sinatra构建一个API(在客户端使用Angular并希望其他人能够访问API)并且它也是一个OAuth提供者。我想知道采取什么最佳途径(利用现有的gem或从Warden推出自己的解决方案等)。在使用Rails之前使用过devise和doorkeeper进行身份验证和oauth,想知道Sinatra的最佳解决方案是什么。理想情况下,我不想要View或能够扩展/修改现有解决方案的操作,因为我纯粹将其作为API与之交互。 最佳答案 我最近使用S/O的以下答案做了同样的事情Whatisaverysimpleauthentic

  5. ruby-on-rails - REST API 文档生成 - 2

    是否有库提供用于编写​​RESTAPI文档的标记?我见过几家公司使用类似的文档模式,例如:http://api.teamlab.com/2.0/http://www.fullcontact.com/docs/?category=person我想知道他们是否使用相同的库或服务。本质上,该库应该根据标记文本生成用于API导航、搜索和显示的页面(很像用于ruby​​文档的YARD)。这是我目前发现的:rapi_docgem.这是一个article讨论用法。 最佳答案 你绝对应该看看Swagger.它是开源的,被数百个API使用,也被3sc

  6. ruby-on-rails - 留下未使用的 REST 操作不好吗? - 2

    我真的很困惑如何做到这一点。我也感到疲倦和沮丧,我的大脑因看到这么多不同的东西而受伤。保留未使用的REST操作是一种不好的做法吗?例如,我有一个资源模型,用户可以提交它们,但我不需要“索引”操作来显示它们,因为这是由Home#indexController处理的。我想要做的就是使用link_to转到带有表单的页面以添加新资源。所以现在我尝试做的所有link_to都在我做resources_path时继续尝试去/resources。我阅读了如何使用“遗留”方法并直接链接到Controller中的操作,但这不是“rails方式”。现在,如果我不使用默认情况下执行的所有不同REST操作,我将

  7. ruby - 使用 Rest Client Ruby Gem 的身份验证 header - 2

    我已经创建了一个基本的身份验证key,现在我只是想使用它。我尝试了几种不同的变体,但似乎都没有在请求header中显示授权。$auth='BasiccmFtZXNoQHVzYW1hLmNvbTpyYW1lc2h1JEBtcA=='@response=resource.post('Authorization'=>$auth)nor@response=resource.post(:authorization=>$auth)nor@response=resource.post(:Authorization=>$auth)nor@response=resource.post(:content_

  8. ruby - Sinatra 构建 REST API 文档 - 2

    关闭。这个问题不符合StackOverflowguidelines.它目前不接受答案。我们不允许提问寻求书籍、工具、软件库等的推荐。您可以编辑问题,以便用事实和引用来回答。关闭4年前。Improvethisquestion我整晚都在寻找gem来从我的sinatra路由生成API文档。我应该能够使用内嵌注释进行指定。我找到了https://rubygems.org/gems/sinatra-api-docs&https://rubygems.org/gems/sinatra-croon但两者似乎都不适用于我的设置并且也已过时..另一个选项是带有一些sinatra插件的庭院,但在生成文档时

  9. Ruby,从 Date.day_fraction_to_time 获取小时、秒和时间 - 2

    我找到了这个方法here.start=DateTime.nowsleep15stop=DateTime.now#minutesputs((stop-start)*24*60).to_ihours,minutes,seconds,frac=Date.day_fraction_to_time(stop-start)我有以下错误:`':privatemethod`day_fraction_to_time'calledforDate:Class(NoMethodError)我检查了/usr/lib/ruby/1.9.1/date.rb并找到了它:defday_fraction_to_time(

  10. ruby-on-rails - 使用 authlogic_api 访问 Rails REST API - 2

    我正在为只能通过REST调用访问的Steam游戏编写Rails后端API,因此不需要特定于用户的身份验证。我正在尝试实现authlogic_apiplug-in对于Authlogicgem,它使用api_key/signature机制来限制访问。我已经实现了rdoc中概述的ApplicationSession和ApplicationAccount模型,但我不确定如何修改我的ApplicationController以限制访问。查看源代码,似乎authlogic_api插件修改了Authlogic的ActsAsAuthentic和Session模块。但由于这本质上是“单一访问”身份验证,

随机推荐