主頁 > 後端開發 > Spring Boot整合swagger使用教程

Spring Boot整合swagger使用教程

2020-09-30 23:09:53 後端開發

目錄
  • Swagger的介紹
    • 優點與缺點
  • 添加swagger
    • 1.添加依賴包：
    • 2.配置Swagger:
    • 3.測驗
  • 場景：
    • 定義介面組
    • 定義介面
    • 定義介面請求引數
      • 場景一：請求引數是物體類，
      • 場景二：請求引數是非物體類，
    • 定義介面回應
      • 回應是物體類：
      • 回應是非物體類：
  • Swagger UI增強
    • UI對比：
    • 使用
    • 優點
  • 整合Spring Security注意
  • 對于token的處理
  • Swagger的安全管理

Swagger的介紹

??你可能嘗試過寫完一個介面后，自己去創建介面檔案，或者修改介面后修改介面檔案，多了之后，你肯定會發生一個操作，那就是忘記了修改檔案或者創建檔案（除非你們公司把介面檔案和寫介面要求得很緊密??忘記寫檔案就扣工資？，否則兩個分離的作業總是有可能遺漏的），而swagger就是一個在你寫介面的時候自動幫你生成介面檔案的東西，只要你遵循它的規范并寫一些介面的說明注解即可，


優點與缺點

??優點：

  • 自動生成檔案，只需要在介面中使用注解進行標注，就能生成對應的介面檔案，
  • 自動更新檔案，由于是動態生成的，所以如果你修改了介面，檔案也會自動對應修改（如果你也更新了注解的話），這樣就不會發送我修改了介面，卻忘記更新介面檔案的情況，
  • 支持在線除錯，swagger提供了在線呼叫介面的功能，

??缺點：

  • 不能創建測驗用例，所以他暫時不能幫你處理完所有的事情，他只能提供一個簡單的在線除錯，如果你想存盤你的測驗用例，可以使用Postman或者YAPI這樣支持創建測驗用戶的功能，
  • 要遵循一些規范，它不是任意規范的，比如說，你可能會回傳一個json資料，而這個資料可能是一個Map格式的，那么我們此時不能標注這個Map格式的回傳資料的每個欄位的說明，而如果它是一個物體類的話，我們可以通過標注類的屬性來給回傳欄位加說明，也比如說，對于swagger，不推薦在使用GET方式提交資料的時候還使用Body，僅推薦使用query引數、header引數或者路徑引數，當然了這個限制只適用于在線除錯，
  • 沒有介面檔案更新管理，雖然一個介面更新之后，可能不會關心舊版的介面資訊，但你“可能”想看看舊版的介面資訊，例如有些灰度更新發布的時候可能還會關心舊版的介面，那么此時只能由后端去看看有沒有注釋留下了，所以可以考慮介面檔案大更新的時候注釋舊版的，然后寫下新版的，【當然這個問題可以通過匯出介面檔案來對比，】
  • 雖然現在Java的物體類中有不少模型，po,dto,vo等，模型的區分是為了屏蔽一些多余引數，比如一個用戶登錄的時候只需要username,password，但查權限的時候需要連接上權限表的資訊，而如果上述兩個操作都是使用了User這個物體的話，在檔案中就會自動生成了多余的資訊，這就要求了你基于模型來創建多個物體類，比如登錄的時候一個LoginForm，需要用戶-權限等資訊的時候才使用User類，（當然了，這個問題等你會swagger之后你就大概就會怎么規避這個問題了，）

??上面的缺點好像寫的有點多，你可能會覺得swagger這個坑有點大，但其實主要是規范問題，而規范問題有時候又會提高你的代碼規范性，這個就見仁見智了，你以前可能什么介面的引數都使用一個類，而現在swagger要求你分開后，某種層次上提高了你的代碼規范性，


??注：以下代碼示例基于Spring Boot，完整代碼可以參考：swagger-demo


添加swagger

??這里先講添加swagger，也就是先整合進來，至于怎么使用，下面的“場景”中再講解，


1.添加依賴包：

?注意，這里的前提是已經匯入了spring boot的web包，

        <dependency>
            <groupId>io.springfox</groupId>
            <artifactId>springfox-swagger2</artifactId>
            <version>2.9.2</version>
        </dependency>
        <dependency>
            <groupId>io.springfox</groupId>
            <artifactId>springfox-swagger-ui</artifactId>
            <version>2.9.2</version>
        </dependency>

2.配置Swagger:

要使用swagger，我們必須對swagger進行配置，我們需要創建一個swagger的配置類，比如可以命名為SwaggerConfig.java

package com.example.config;

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import springfox.documentation.builders.ApiInfoBuilder;
import springfox.documentation.builders.PathSelectors;
import springfox.documentation.builders.RequestHandlerSelectors;
import springfox.documentation.service.ApiInfo;
import springfox.documentation.spi.DocumentationType;
import springfox.documentation.spring.web.plugins.Docket;
import springfox.documentation.swagger2.annotations.EnableSwagger2;


@Configuration // 標明是配置類
@EnableSwagger2 //開啟swagger功能
public class SwaggerConfig {
    @Bean
    public Docket createRestApi() {
        return new Docket(DocumentationType.SWAGGER_2)  // DocumentationType.SWAGGER_2 固定的，代表swagger2
//                .groupName("分布式任務系統") // 如果配置多個檔案的時候，那么需要配置groupName來分組標識
                .apiInfo(apiInfo()) // 用于生成API資訊
                .select() // select()函式回傳一個ApiSelectorBuilder實體,用來控制介面被swagger做成檔案
                .apis(RequestHandlerSelectors.basePackage("com.example.controller")) // 用于指定掃描哪個包下的介面
                .paths(PathSelectors.any())// 選擇所有的API,如果你想只為部分API生成檔案，可以配置這里
                .build();
    }

    /**
     * 用于定義API主界面的資訊，比如可以宣告所有的API的總標題、描述、版本
     * @return
     */
    private ApiInfo apiInfo() {
        return new ApiInfoBuilder()
                .title("XX專案API") //  可以用來自定義API的主標題
                .description("XX專案SwaggerAPI管理") // 可以用來描述整體的API
                .termsOfServiceUrl("") // 用于定義服務的域名
                .version("1.0") // 可以用來定義版本，
                .build(); //
    }
}

3.測驗

運行我們的Spring Boot專案，（我默認是8080埠，如果你不一樣，請注意修改后續的url），訪問http://localhost:8080/swagger-ui.html
然后你就可以看到一個如下的界面，由于我們暫時沒有配置介面資料，所以下面顯示No operations defined in spec!

20200711013419


??下面我們將介紹如何定義介面，以及在swagger UI界面中的內容，


場景：

定義介面組

介面有時候應該是分組的，而且大部分都是在一個controller中的，比如用戶管理相關的介面應該都在UserController中，那么不同的業務的時候，應該定義/劃分不同的介面組，介面組可以使用@Api來劃分，
比如：

@Api(tags = "角色管理") //  tags：你可以當作是這個組的名字，
@RestController
public class RoleController {
}

和

@Api(tags = "用戶管理") //  tags：你可以當作是這個組的名字，
@RestController
public class UserController {
}

??你也可以理解成基于tags來分組，就好像一些文章里面的標簽一樣，使用標簽來分類，
??如果這個Controller下（介面組）下面沒有介面，那么在swagger ui中是不會顯示的，如果有的話就會這樣顯示：
20200712022545



定義介面

使用了@Api來標注一個Controller之后，如果下面有介面，那么就會默認生成檔案，但沒有我們自定義的說明：

@Api(tags = "用戶管理")
@RestController
public class UserController {
    // 注意，對于swagger，不要使用@RequestMapping，
    // 因為@RequestMapping支持任意請求方式，swagger會為這個介面生成7種請求方式的介面檔案
    @GetMapping("/info") 
    public String info(String id){
        return "aaa";
    }
}

20200711015840

20200711020149



我們可以使用@ApiOperation來描述介面，比如：

    @ApiOperation(value = "https://www.cnblogs.com/progor/p/用戶測驗",notes = "用戶測驗notes")
    @GetMapping("/test")
    public String test(String id){
        return "test";
    }

20200711021112
常用配置項：

  • value：可以當作是介面的簡稱
  • notes：介面的描述
  • tags：可以額外定義介面組，比如這個介面外層已經有@Api(tags = "用戶管理")，將介面劃分到了“用戶管理”中，但你可以額外的使用tags，例如tags = "角色管理"讓角色管理中也有這個介面檔案，


定義介面請求引數

上面使用了@ApiOperation來了描述介面，但其實還缺少介面請求引數的說明，下面我們分場景來講，
??注意一下，對于GET方式，swagger不推薦使用body方式來傳遞資料，也就是不希望在GET方式時使用json、form-data等方式來傳遞，這時候最好使用路徑引數或者url引數，(??雖然POSTMAN等是支持的)，所以如果介面傳遞的資料是json或者form-data方式的，還是使用POST方式好，

場景一：請求引數是物體類，

此時我們需要使用@ApiModel來標注物體類，然后在介面中定義入參為物體類即可：

  • @ApiModel：用來標類
    • 常用配置項：
      • value：物體類簡稱
      • description：物體類說明
  • @ApiModelProperty：用來描述類的欄位的意義，
    • 常用配置項：
      • value：欄位說明
      • example：設定請求示例（Example Value）的默認值，如果不配置，當欄位為string的時候，此時請求示例中默認值為"".
      • name：用新的欄位名來替代舊的欄位名，
      • allowableValues：限制值得范圍，例如{1,2,3}代表只能取這三個值；[1,5]代表取1到5的值；(1,5)代表1到5的值，不包括1和5；還可以使用infinity或-infinity來無限值，比如[1, infinity]代表最小值為1，最大值無窮大，
      • required：標記欄位是否必填，默認是false,
      • hidden：用來隱藏欄位，默認是false，如果要隱藏需要使用true，因為欄位默認都會顯示，就算沒有@ApiModelProperty，
// 先使用@ApiModel來標注類
@ApiModel(value="https://www.cnblogs.com/progor/p/用戶登錄表單物件",description="用戶登錄表單物件")
public class LoginForm {
    // 使用ApiModelProperty來標注欄位屬性，
    @ApiModelProperty(value = "https://www.cnblogs.com/progor/p/用戶名",required = true,example = "root")
    private String username;
    @ApiModelProperty(value = "https://www.cnblogs.com/progor/p/密碼",required = true,example = "123456")
    private String password;

    // 此處省略入參賦值時需要的getter,setter,swagger也需要這個
}

定義成入參：

    @ApiOperation(value = "https://www.cnblogs.com/progor/p/登錄介面",notes = "登錄介面的說明")
    @PostMapping("/login")
    public LoginForm login(@RequestBody LoginForm loginForm){
        return loginForm;
    }

效果：

20200711181038



場景二：請求引數是非物體類，

（再說一次：對于GET方式，swagger不推薦使用body方式來傳遞資料，所以雖然Spring MVC可以自動封裝引數，但對于GET請求還是不要使用form-data，json等方式傳遞引數，除非你使用Postman來測驗介面，swagger在線測驗是不支持這個操作的）
對于非物體類引數，可以使用@ApiImplicitParams和@ApiImplicitParam來宣告請求引數，
@ApiImplicitParams用在方法頭上，@ApiImplicitParam定義在@ApiImplicitParams里面，一個@ApiImplicitParam對應一個引數，
@ApiImplicitParam常用配置項：

  • name：用來定義引數的名字，也就是欄位的名字,可以與介面的入參名對應，如果不對應，也會生成，所以可以用來定義額外引數！
  • value：用來描述引數
  • required：用來標注引數是否必填
  • paramType有path,query,body,form,header等方式，但對于對于非物體類引數的時候，常用的只有path,query,header；body和form是不常用的，body不適用于多個零散引數的情況，只適用于json物件等情況，【如果你的介面是form-data,x-www-form-urlencoded的時候可能不能使用swagger頁面API除錯，但可以在后面講到基于BootstrapUI的swagger增強中除錯，基于BootstrapUI的swagger支持指定form-data或x-www-form-urlencoded】

示例一：宣告入參是URL引數

    // 使用URL query引數
    @ApiOperation(value = "https://www.cnblogs.com/progor/p/登錄介面2",notes = "登錄介面的說明2")
    @ApiImplicitParams({
            @ApiImplicitParam(name = "username",//引數名字
                    value = "https://www.cnblogs.com/progor/p/用戶名",//引數的描述
                    required = true,//是否必須傳入
                    //paramType定義引數傳遞型別：有path,query,body,form,header
                    paramType = "query"
                    )
            ,
            @ApiImplicitParam(name = "password",//引數名字
                    value = "https://www.cnblogs.com/progor/p/密碼",//引數的描述
                    required = true,//是否必須傳入
                    paramType = "query"
                    )
    })
    @PostMapping(value = "https://www.cnblogs.com/login2")
    public LoginForm login2(String username,String password){
        System.out.println(username+":"+password);
        LoginForm loginForm = new LoginForm();
        loginForm.setUsername(username);
        loginForm.setPassword(password);
        return loginForm;
    }

示例二：宣告入參是URL路徑引數

    // 使用路徑引數
    @PostMapping("/login3/{id1}/{id2}")
    @ApiOperation(value = "https://www.cnblogs.com/progor/p/登錄介面3",notes = "登錄介面的說明3")
    @ApiImplicitParams({
            @ApiImplicitParam(name = "id1",//引數名字
                    value = "https://www.cnblogs.com/progor/p/用戶名",//引數的描述
                    required = true,//是否必須傳入
                    //paramType定義引數傳遞型別：有path,query,body,form,header
                    paramType = "path"
            )
            ,
            @ApiImplicitParam(name = "id2",//引數名字
                    value = "https://www.cnblogs.com/progor/p/密碼",//引數的描述
                    required = true,//是否必須傳入
                    paramType = "path"
            )
    })
    public String login3(@PathVariable Integer id1,@PathVariable Integer id2){
        return id1+":"+id2;
    }

示例三：宣告入參是header引數

    // 用header傳遞引數
    @PostMapping("/login4")
    @ApiOperation(value = "https://www.cnblogs.com/progor/p/登錄介面4",notes = "登錄介面的說明4")
    @ApiImplicitParams({
            @ApiImplicitParam(name = "username",//引數名字
                    value = "https://www.cnblogs.com/progor/p/用戶名",//引數的描述
                    required = true,//是否必須傳入
                    //paramType定義引數傳遞型別：有path,query,body,form,header
                    paramType = "header"
            )
            ,
            @ApiImplicitParam(name = "password",//引數名字
                    value = "https://www.cnblogs.com/progor/p/密碼",//引數的描述
                    required = true,//是否必須傳入
                    paramType = "header"
            )
    })
    public String login4( @RequestHeader String username,
                          @RequestHeader String password){
        return username+":"+password;
    }

示例四：宣告檔案上傳引數

    // 有檔案上傳時要用@ApiParam，用法基本與@ApiImplicitParam一樣，不過@ApiParam用在引數上
    // 或者你也可以不注解，swagger會自動生成說明
    @ApiOperation(value = "https://www.cnblogs.com/progor/p/上傳檔案",notes = "上傳檔案")
    @PostMapping(value = "https://www.cnblogs.com/upload")
    public String upload(@ApiParam(value = "https://www.cnblogs.com/progor/p/圖片檔案", required = true)MultipartFile uploadFile){
        String originalFilename = uploadFile.getOriginalFilename();

        return originalFilename;
    }
    

    // 多個檔案上傳時，**swagger只能測驗單檔案上傳**
    @ApiOperation(value = "https://www.cnblogs.com/progor/p/上傳多個檔案",notes = "上傳多個檔案")
    @PostMapping(value = "https://www.cnblogs.com/upload2",consumes = "multipart/*", headers = "content-type=multipart/form-data")
    public String upload2(@ApiParam(value = "https://www.cnblogs.com/progor/p/圖片檔案", required = true,allowMultiple = true)MultipartFile[] uploadFile){
        StringBuffer sb = new StringBuffer();
        for (int i = 0; i < uploadFile.length; i++) {
            System.out.println(uploadFile[i].getOriginalFilename());
            sb.append(uploadFile[i].getOriginalFilename());
            sb.append(",");
        }
        return sb.toString();
    }



    // 既有檔案，又有引數
    @ApiOperation(value = "https://www.cnblogs.com/progor/p/既有檔案，又有引數",notes = "既有檔案，又有引數")
    @PostMapping(value = "https://www.cnblogs.com/upload3")
    @ApiImplicitParams({
            @ApiImplicitParam(name = "name",
                    value = "https://www.cnblogs.com/progor/p/圖片新名字",
                    required = true
            )
    })
    public String upload3(@ApiParam(value = "https://www.cnblogs.com/progor/p/圖片檔案", required = true)MultipartFile uploadFile,
                          String name){
        String originalFilename = uploadFile.getOriginalFilename();

        return originalFilename+":"+name;
    }


定義介面回應

定義介面回應，是方便查看介面檔案的人能夠知道介面回傳的資料的意義，

回應是物體類：

前面在定義介面請求引數的時候有提到使用@ApiModel來標注類，如果介面回傳了這個類，那么這個類上的說明也會作為回應的說明：


    // 回傳被@ApiModel標注的類物件
    @ApiOperation(value = "https://www.cnblogs.com/progor/p/物體類回應",notes = "回傳資料為物體類的介面")
    @PostMapping("/role1")
    public LoginForm role1(@RequestBody LoginForm loginForm){
        return loginForm;
    }

20200712000406



回應是非物體類：

swagger無法對非物體類的回應進行詳細說明，只能標注回應碼等資訊，是通過@ApiResponses和@ApiResponse來實作的，
@ApiResponses和@ApiResponse可以與@ApiModel一起使用，

    // 其他型別的,此時不能增加欄位注釋，所以其實swagger推薦使用物體類
    @ApiOperation(value = "https://www.cnblogs.com/progor/p/非物體類",notes = "非物體類")
    @ApiResponses({
            @ApiResponse(code=200,message = "呼叫成功"),
            @ApiResponse(code=401,message = "無權限" )
    }
    )
    @PostMapping("/role2")
    public String role2(){
        return " {\n" +
                " name:\"廣東\",\n" +
                "     citys:{\n" +
                "         city:[\"廣州\",\"深圳\",\"珠海\"]\n" +
                "     }\n" +
                " }";
    }

20200712013503


Swagger UI增強

你可能會覺得現在這個UI不是很好看，現在有一些第三方提供了一些Swagger UI增強，比較流行的是swagger-bootstrap-ui，我們這里以swagger-bootstrap-ui為例，

UI對比：

20200712013653

20200712013723



使用

1.添加依賴包：

        <!--引入swagger-->
        <dependency>
            <groupId>io.springfox</groupId>
            <artifactId>springfox-swagger2</artifactId>
            <version>2.9.2</version>
        </dependency>
        <dependency>
            <groupId>io.springfox</groupId>
            <artifactId>springfox-swagger-ui</artifactId>
            <version>2.9.2</version>
        </dependency>
        <!-- 引入swagger-bootstrap-ui依賴包-->
        <dependency>
            <groupId>com.github.xiaoymin</groupId>
            <artifactId>swagger-bootstrap-ui</artifactId>
            <version>1.8.7</version>
        </dependency>

2.在swagger配置類中增加注解@EnableSwaggerBootstrapUI:

@Configuration // 標明是配置類
@EnableSwagger2 //開啟swagger功能
@EnableSwaggerBootstrapUI // 開啟SwaggerBootstrapUI
public class SwaggerConfig {
    // 省略配置內容
}

3.訪問API：http://localhost:8080/doc.html，即可預覽到基于bootstarp的Swagger UI界面，



優點

1.??界面好看了一點

2.上面說過了，基于BootstrapUI的swagger支持指定form-data或x-www-form-urlencoded：
20200712024858

3.支持復制單個API檔案和匯出全部API檔案：
20200712025020

20200712025044



整合Spring Security注意

在Spring Boot整合Spring Security和Swagger的時候，需要配置攔截的路徑和放行的路徑，注意是放行以下幾個路徑，

.antMatchers("/swagger**/**").permitAll()
.antMatchers("/webjars/**").permitAll()
.antMatchers("/v2/**").permitAll()
.antMatchers("/doc.html").permitAll() // 如果你用了bootstarp的Swagger UI界面，加一個這個，


對于token的處理

在swagger中只支持了簡單的除錯，但對于一些介面，我們測驗的時候可能需要把token資訊寫到header中，目前好像沒看到可以自定義加請求頭的地方？
??方法一：
　　如果你使用了Swagger BootstrapUI，那么你可以在“檔案管理”中增加全域引數，這包括了添加header引數，

??方法二：在swagger配置類中增加全域引數配置：

        //如果有額外的全域引數，比如說請求頭引數，可以這樣添加
        ParameterBuilder parameterBuilder = new ParameterBuilder();
        List<Parameter> parameters = new ArrayList<Parameter>();
        parameterBuilder.name("authorization").description("令牌")
                .modelRef(new ModelRef("string")).parameterType("header").required(false).build();
        parameters.add(parameterBuilder.build());
        return new Docket(DocumentationType.SWAGGER_2)  // DocumentationType.SWAGGER_2 固定的，代表swagger2
                .apiInfo(apiInfo()) // 用于生成API資訊
                .select() // select()函式回傳一個ApiSelectorBuilder實體,用來控制介面被swagger做成檔案
                .apis(RequestHandlerSelectors.basePackage("com.example.controller")) // 用于指定掃描哪個包下的介面
                .paths(PathSelectors.any())// 選擇所有的API,如果你想只為部分API生成檔案，可以配置這里
                .build().globalOperationParameters(parameters);

??方法三：使用@ApiImplicitParams來額外標注一個請求頭引數，例如：

    // 如果需要額外的引數，非本方法用到，但過濾器要用,類似于權限token
    @PostMapping("/login6")
    @ApiOperation(value = "https://www.cnblogs.com/progor/p/帶token的介面",notes = "帶token的介面")
    @ApiImplicitParams({
            @ApiImplicitParam(name = "authorization",//引數名字
                    value = "https://www.cnblogs.com/progor/p/授權token",//引數的描述
                    required = true,//是否必須傳入
                    paramType = "header"
            )
            ,
            @ApiImplicitParam(name = "username",//引數名字
                    value = "https://www.cnblogs.com/progor/p/用戶名",//引數的描述
                    required = true,//是否必須傳入
                    paramType = "query"
            )
    })
    public String login6(String username){
        return username;
    }


Swagger的安全管理

1.如果你整合了權限管理，可以給swagger加上權限管理，要求訪問swagger頁面輸入用戶名和密碼，這些是spring security和shiro的事了，這里不講，


2.如果你僅僅是不想在正式環境中可以訪問，可以在正式環境中關閉Swagger自動配置，這就不會有swagger頁面了，使用@Profile({"dev","test"})注解來限制只在dev或者test下啟用Swagger自動配置，
然后在Spring Boot組態檔中修改當前profilespring.profiles.active=release，重啟之后，此時無法訪問http://localhost:8080/swagger-ui.html


轉載請註明出處，本文鏈接：https://www.uj5u.com/houduan/143461.html

標籤：Java

上一篇：如何用c++讀取EXCEL單元格里的檔案名后做檔案夾里的相應檔案做交集運算

下一篇：萬字長文，62道Java核心面試題，一次性打包送給積極向上的你

標籤雲
其他(157675) Python(38076) JavaScript(25376) Java(17977) C(15215) 區塊鏈(8255) C＃(7972) AI(7469) 爪哇(7425) MySQL(7132) html(6777) 基礎類(6313) sql(6102) 熊猫(6058) PHP(5869) 数组(5741) R(5409) Linux(5327) 反应(5209) 腳本語言(PerlPython)(5129) 非技術區(4971) Android(4554) 数据框(4311) css(4259) 节点.js(4032) C語言(3288) json(3245) 列表(3129) 扑(3119) C++語言(3117) 安卓(2998) 打字稿(2995) VBA(2789) Java相關(2746) 疑難問題(2699) 细绳(2522) 單片機工控(2479) iOS(2429) ASP.NET(2402) MongoDB(2323) 麻木的(2285) 正则表达式(2254) 字典(2211) 循环(2198) 迅速(2185) 擅长(2169) 镖(2155) 功能(1967) .NET技术(1958) Web開發(1951) python-3.x(1918) HtmlCss(1915) 弹簧靴(1913) C++(1909) xml(1889) PostgreSQL(1872) .NETCore(1853) 谷歌表格(1846) Unity3D(1843) for循环(1842)

熱門瀏覽
  • 【C++】Microsoft C++、C 和匯編程式檔案

    ......

    uj5u.com 2020-09-10 00:57:23 more
  • 例外宣告

    相比于斷言適用于排除邏輯上不可能存在的狀態，例外通常是用于邏輯上可能發生的錯誤。 例外宣告 Item 1：當函式不可能拋出例外或不能接受拋出例外時，使用noexcept 理由 如果不打算拋出例外的話，程式就會認為無法處理這種錯誤，并且應當盡早終止，如此可以有效地阻止例外的傳播與擴散。 示例 //不可 ......

    uj5u.com 2020-09-10 00:57:27 more
  • Codeforces 1400E Clear the Multiset(貪心 + 分治)

    鏈接：https://codeforces.com/problemset/problem/1400/E 來源：Codeforces 思路：給你一個陣列，現在你可以進行兩種操作，操作1：將一段沒有 0 的區間進行減一的操作，操作2：將 i 位置上的元素歸零。最終問：將這個陣列的全部元素歸零后操作的最少 ......

    uj5u.com 2020-09-10 00:57:30 more
  • UVA11610 【Reverse Prime】

    本人看到此題沒有翻譯，就附帶了一個自己的翻譯版本 思考 這一題，它的第一個要求是找出所有 $7$ 位反向質數及其質因數的個數。 我們應該需要質數篩篩選1~$10^{7}$的所有數，這里就不慢慢介紹了。但是，重讀題，我們突然發現反向質數都是 $7$ 位，而將它反過來后的數字卻是 $6$ 位數，這就說明 ......

    uj5u.com 2020-09-10 00:57:36 more
  • 統計區間素數數量

    1 #pragma GCC optimize(2) 2 #include <bits/stdc++.h> 3 using namespace std; 4 bool isprime[1000000010]; 5 vector<int> prime; 6 inline int getlist(int ......

    uj5u.com 2020-09-10 00:57:47 more
  • C/C++編程筆記：C++中的 const 變數詳解，教你正確認識const用法

    1、C中的const 1、區域const變數存放在堆疊區中，會分配記憶體（也就是說可以通過地址間接修改變數的值）。測驗代碼如下： 運行結果： 2、全域const變數存放在只讀資料段（不能通過地址修改，會發生寫入錯誤）， 默認為外部聯編，可以給其他源檔案使用（需要用extern關鍵字修飾） 運行結果： ......

    uj5u.com 2020-09-10 00:58:04 more
  • 【C++犯錯記錄】VS2019 MFC添加資源不懂如何修改資源宏ID

    1. 首先在資源視圖中，添加資源 2. 點擊新添加的資源，復制自動生成的ID 3. 在解決方案資源管理器中找到Resource.h檔案，編輯，使用整個專案搜索和替換的方式快速替換 宏宣告 4. Ctrl+Shift+F 全域搜索，點擊查找全部，然后逐個替換 5. 為什么使用搜索替換而不使用屬性視窗直 ......

    uj5u.com 2020-09-10 00:59:11 more
  • 【C++犯錯記錄】VS2019 MFC不懂的批量添加資源

    1. 打開資源頭檔案Resource.h，在其中預先定義好宏 ID（不清楚其實ID值應該設定多少，可以先新建一個相同的資源項，再在這個資源的ID值的基礎上遞增即可） 2. 在資源視圖中選中專案資源，按F7編輯資源檔案，按 ID 型別 相對路徑的形式添加 資源。（別忘了先把檔案拷貝到專案中的res檔案 ......

    uj5u.com 2020-09-10 01:00:19 more
  • C/C++編程筆記：關于C++的參考型別，專供新手入門使用

    今天要講的是C++中我最喜歡的一個用法——參考，也叫別名。 參考就是給一個變數名取一個變數名，方便我們間接地使用這個變數。我們可以給一個變數創建N個參考，這N + 1個變數共享了同一塊記憶體區域。(參考型別的變數會占用記憶體空間，占用的記憶體空間的大小和指標型別的大小是相同的。雖然參考是一個物件的別名，但 ......

    uj5u.com 2020-09-10 01:00:22 more
  • 【C/C++編程筆記】從頭開始學習C ++：初學者完整指南

    眾所周知，C ++的學習曲線陡峭，但是花時間學習這種語言將為您的職業帶來奇跡，并使您與其他開發人員區分開。您會更輕松地學習新語言，形成真正的解決問題的技能，并在編程的基礎上打下堅實的基礎。 C ++將幫助您養成良好的編程習慣（即清晰一致的編碼風格，在撰寫代碼時注釋代碼，并限制類內部的可見性），并且由 ......

    uj5u.com 2020-09-10 01:00:41 more
最新发布
  • Rust中的智能指標:Box<T> Rc<T> Arc<T> Cell<T> RefCell<T> Weak

    Rust中的智能指標是什么 智能指標（smart pointers）是一類資料結構，是擁有資料所有權和額外功能的指標。是指標的進一步發展 指標（pointer）是一個包含記憶體地址的變數的通用概念。這個地址參考，或 ” 指向”（points at）一些其 他資料 。參考以 & 符號為標志并借用了他們所 ......

    uj5u.com 2023-04-20 07:24:10 more
  • Java的值傳遞和參考傳遞

    值傳遞不會改變本身，參考傳遞（如果傳遞的值需要實體化到堆里）如果發生修改了會改變本身。 1.基本資料型別都是值傳遞 package com.example.basic; public class Test { public static void main(String[] args) { int ......

    uj5u.com 2023-04-20 07:24:04 more
  • [2]SpinalHDL教程——Scala簡單入門

    第一個 Scala 程式 shell里面輸入 $ scala scala> 1 + 1 res0: Int = 2 scala> println("Hello World!") Hello World! 檔案形式 object HelloWorld { /* 這是我的第一個 Scala 程式 * 以 ......

    uj5u.com 2023-04-20 07:23:58 more
  • 理解函式指標和回呼函式

    理解 函式指標 指向函式的指標。比如： 理解函式指標的偽代碼 void (*p)(int type, char *data); // 定義一個函式指標p void func(int type, char *data); // 宣告一個函式func p = func; // 將指標p指向函式func ......

    uj5u.com 2023-04-20 07:23:52 more
  • Django筆記二十五之資料庫函式之日期函式

    本文首發于公眾號：Hunter后端 原文鏈接：Django筆記二十五之資料庫函式之日期函式 日期函式主要介紹兩個大類，Extract() 和 Trunc() Extract() 函式作用是提取日期，比如我們可以提取一個日期欄位的年份，月份，日等資料 Trunc() 的作用則是截取，比如 2022-0 ......

    uj5u.com 2023-04-20 07:23:45 more
  • 一天吃透JVM面試八股文

    什么是JVM？ JVM，全稱Java Virtual Machine（Java虛擬機），是通過在實際的計算機上仿真模擬各種計算機功能來實作的。由一套位元組碼指令集、一組暫存器、一個堆疊、一個垃圾回收堆和一個存盤方法域等組成。JVM屏蔽了與作業系統平臺相關的資訊，使得Java程式只需要生成在Java虛擬機 ......

    uj5u.com 2023-04-20 07:23:31 more
  • 使用Java接入小程式訂閱訊息！

    更新完微信服務號的模板訊息之后，我又趕緊把微信小程式的訂閱訊息給實作了！之前我一直以為微信小程式也是要企業才能申請，沒想到小程式個人就能申請。 訊息推送平臺🔥推送下發【郵件】【短信】【微信服務號】【微信小程式】【企業微信】【釘釘】等訊息型別。 https://gitee.com/zhongfuch ......

    uj5u.com 2023-04-20 07:22:59 more
  • java -- 緩沖流、轉換流、序列化流

    緩沖流 緩沖流, 也叫高效流, 按照資料型別分類： 位元組緩沖流：BufferedInputStream，BufferedOutputStream 字符緩沖流：BufferedReader，BufferedWriter 緩沖流的基本原理，是在創建流物件時，會創建一個內置的默認大小的緩沖區陣列，通過緩沖 ......

    uj5u.com 2023-04-20 07:22:49 more
  • Java-SpringBoot-Range請求頭設定實作視頻分段傳輸

    老實說，人太懶了，現在基本都不喜歡寫筆記了，但是網上有關Range請求頭的文章都太水了 下面是抄的一段StackOverflow的代碼...自己大修改過的，寫的注釋挺全的，應該直接看得懂，就不解釋了 寫的不好...只是希望能給視頻網站開發的新手一點點幫助吧. 業務場景：視頻分段傳輸、視頻多段傳輸（理 ......

    uj5u.com 2023-04-20 07:22:42 more
  • Windows 10開發教程_編程入門自學教程_菜鳥教程-免費教程分享

    教程簡介 Windows 10開發入門教程 - 從簡單的步驟了解Windows 10開發，從基本到高級概念，包括簡介，UWP，第一個應用程式，商店，XAML控制元件，資料系結，XAML性能，自適應設計，自適應UI，自適應代碼，檔案管理，SQLite資料庫，應用程式到應用程式通信，應用程式本地化，應用程式 ......

    uj5u.com 2023-04-20 07:22:35 more

Copyright © 2010-2020 有解無憂