├── settings.gradle ├── gradle └── wrapper │ ├── gradle-wrapper.jar │ └── gradle-wrapper.properties ├── gradlew.bat ├── README.md ├── src └── test │ └── java │ └── TestaCliente.java └── gradlew /settings.gradle: -------------------------------------------------------------------------------- 1 | rootProject.name = 'ExemploTesteApiRestAssured' 2 | 3 | -------------------------------------------------------------------------------- /gradle/wrapper/gradle-wrapper.jar: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/vinnypessoni/teste-api-clientes-restassured-java-gradle-junit5/HEAD/gradle/wrapper/gradle-wrapper.jar -------------------------------------------------------------------------------- /gradle/wrapper/gradle-wrapper.properties: -------------------------------------------------------------------------------- 1 | #Sat Mar 14 19:53:54 GMT 2020 2 | distributionUrl=https\://services.gradle.org/distributions/gradle-6.7-all.zip 3 | distributionBase=GRADLE_USER_HOME 4 | distributionPath=wrapper/dists 5 | zipStorePath=wrapper/dists 6 | zipStoreBase=GRADLE_USER_HOME 7 | -------------------------------------------------------------------------------- /gradlew.bat: -------------------------------------------------------------------------------- 1 | @if "%DEBUG%" == "" @echo off 2 | @rem ########################################################################## 3 | @rem 4 | @rem Gradle startup script for Windows 5 | @rem 6 | @rem ########################################################################## 7 | 8 | @rem Set local scope for the variables with windows NT shell 9 | if "%OS%"=="Windows_NT" setlocal 10 | 11 | set DIRNAME=%~dp0 12 | if "%DIRNAME%" == "" set DIRNAME=. 13 | set APP_BASE_NAME=%~n0 14 | set APP_HOME=%DIRNAME% 15 | 16 | @rem Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script. 17 | set DEFAULT_JVM_OPTS="-Xmx64m" 18 | 19 | @rem Find java.exe 20 | if defined JAVA_HOME goto findJavaFromJavaHome 21 | 22 | set JAVA_EXE=java.exe 23 | %JAVA_EXE% -version >NUL 2>&1 24 | if "%ERRORLEVEL%" == "0" goto init 25 | 26 | echo. 27 | echo ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH. 28 | echo. 29 | echo Please set the JAVA_HOME variable in your environment to match the 30 | echo location of your Java installation. 31 | 32 | goto fail 33 | 34 | :findJavaFromJavaHome 35 | set JAVA_HOME=%JAVA_HOME:"=% 36 | set JAVA_EXE=%JAVA_HOME%/bin/java.exe 37 | 38 | if exist "%JAVA_EXE%" goto init 39 | 40 | echo. 41 | echo ERROR: JAVA_HOME is set to an invalid directory: %JAVA_HOME% 42 | echo. 43 | echo Please set the JAVA_HOME variable in your environment to match the 44 | echo location of your Java installation. 45 | 46 | goto fail 47 | 48 | :init 49 | @rem Get command-line arguments, handling Windows variants 50 | 51 | if not "%OS%" == "Windows_NT" goto win9xME_args 52 | 53 | :win9xME_args 54 | @rem Slurp the command line arguments. 55 | set CMD_LINE_ARGS= 56 | set _SKIP=2 57 | 58 | :win9xME_args_slurp 59 | if "x%~1" == "x" goto execute 60 | 61 | set CMD_LINE_ARGS=%* 62 | 63 | :execute 64 | @rem Setup the command line 65 | 66 | set CLASSPATH=%APP_HOME%\gradle\wrapper\gradle-wrapper.jar 67 | 68 | @rem Execute Gradle 69 | "%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% "-Dorg.gradle.appname=%APP_BASE_NAME%" -classpath "%CLASSPATH%" org.gradle.wrapper.GradleWrapperMain %CMD_LINE_ARGS% 70 | 71 | :end 72 | @rem End local scope for the variables with windows NT shell 73 | if "%ERRORLEVEL%"=="0" goto mainEnd 74 | 75 | :fail 76 | rem Set variable GRADLE_EXIT_CONSOLE if you need the _script_ return code instead of 77 | rem the _cmd.exe /c_ return code! 78 | if not "" == "%GRADLE_EXIT_CONSOLE%" exit 1 79 | exit /b 1 80 | 81 | :mainEnd 82 | if "%OS%"=="Windows_NT" endlocal 83 | 84 | :omega 85 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | # Framework de Teste Automatizado com Java, RestAssured, Junit5 e Gradle 2 | 3 | Esse é um exemplo de framework de teste automatizado para estudo tanto de programação quanto testes automatizados. 4 | 5 | Ela foi criada para os alunos do curso de teste de APIS com Postman, Java, RestAssured, Gradle e Junit 5 [disponível aqui](https://viniciuspessoni.com/curso-testando-apis-com-postman-do-zero) e também para os alunos da [Comunidade Tester Global](https://viniciuspessoni.com/comunidade-tester-global/) 6 | 7 | Nessa framework de teste usei Java, Junit5, RestAssured e Gradle para programar os testes do microserviço (API) que ensinamos nos cursos mencionados acima. 8 | 9 | ### Estrutura das Branches 10 | 11 | O projeto possui 3 branches com 3 níveis diferentes de complexidade de codificação. 12 | 13 | * Master: nível júnior, para quem está aprendendo do comecinho 14 | 15 | * codigo-refatorado-mid-range: nível esperado de um tester pleno (intermediário) 16 | 17 | * codigo-refatorado-senior: nível esperado de um tester sênior 18 | 19 | Se você está começando a aprender, utiliza a branch master. 20 | 21 | Fique a vontade para baixar esse código para aprender e se desenvolver. 22 | 23 | ### Requisitos 24 | 25 | Baixe e instale o [INTELIJ](https://www.jetbrains.com/idea/) 26 | 27 | Baixe e instale a JDK mais recente [JDK](https://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html) 28 | 29 | 30 | ### Como rodar esse projeto usando o IntelliJ ou Terminal 31 | Clone ou baixe esse projeto em seu computador. 32 | 33 | Clone ou baixe a [API de exemplo do curso de teste de APIS](https://github.com/vinnypessoni/exemplo-API) e a execute de acordo com o README da API. 34 | 35 | 36 | #### Executando pelo IntelliJ 37 | 38 | Após importar esse projeto no IntelliJ, navegue até a pasta src/test/java e abra a classe TestaCliente. 39 | 40 | Um botão verde (um play) deve aparecer ao lado do nome da classe na linha 11, basta apertar ele. 41 | 42 | Os testes serão compilados e os resultados serão exibidos na tela de execução do Intellij. 43 | 44 | #### Executando pelo Terminal 45 | 46 | Uma outra possibilidade é executá-los por meio do terminal. 47 | 48 | Navegue até a pasta em que voceê baixou ou clonou os arquivos e use os comandos: 49 | 50 | Linux/Mac 51 | 52 | ./gradlew clean test 53 | 54 | Windows 55 | 56 | gradlew clean test 57 | 58 | #### Relatórios 59 | 60 | Os resultados dos testes são exibidos na tela do Intellij ou terminal. 61 | 62 | Além disso, geramos um relatório .html a cada execução. 63 | 64 | Esse relatório está na pasta 65 | 66 | build -> reports -> tests -> test -> index.html 67 | 68 | 69 | # Me Segue =} 70 | 71 | 😍 [YouTube]( https://www.youtube.com/c/pessonizando) 72 | 73 | 💗 [Instagram](https://www.instagram.com/pessonizando) 74 | 75 | ⭐ [Telegram](https://t.me/pessonizando) 76 | -------------------------------------------------------------------------------- /src/test/java/TestaCliente.java: -------------------------------------------------------------------------------- 1 | 2 | import io.restassured.http.ContentType; 3 | 4 | import org.hamcrest.core.IsEqual; 5 | import org.junit.jupiter.api.DisplayName; 6 | import org.junit.jupiter.api.Test; 7 | 8 | import static io.restassured.RestAssured.given; 9 | import static org.hamcrest.Matchers.containsString; 10 | 11 | public class TestaCliente { 12 | 13 | private String servicoCliente = "http://localhost:8080"; 14 | private String recursoCliente = "/cliente"; 15 | private String apagaTodosClientes = "/apagaTodos"; 16 | 17 | @Test 18 | @DisplayName("Quando eu requisitar a lista de clientes sem adicionar clientes antes, Então ela deve estar vazia") 19 | public void quandoRequisitarListaClientesSemAdicionar_EntaoElaDeveEstarVazia() { 20 | apagaTodosClientesDoServidor(); 21 | String respostaEsperada = "{}"; 22 | 23 | given() 24 | .contentType(ContentType.JSON) 25 | .when() 26 | .get(servicoCliente) 27 | .then() 28 | .statusCode(200) 29 | .assertThat().body(new IsEqual(respostaEsperada)); 30 | } 31 | 32 | @Test 33 | @DisplayName("Quando eu cadastrar um cliente, Então ele deve ser salvo com sucesso") 34 | public void quandoCadastrarCliente_EntaoEleDeveSerSalvoComSucesso() { 35 | 36 | String corpoRequisicao = "{\n" + 37 | " \"nome\": \"Vinny\",\n" + 38 | " \"idade\": \"30\",\n" + 39 | " \"id\": \"1234\"\n" + 40 | "}"; 41 | 42 | String respostaEsperada = "{\"1234\":" + 43 | "{\"nome\":\"Vinny\"," + 44 | "\"idade\":30," + 45 | "\"id\":1234," + 46 | "\"risco\":0}" + 47 | "}"; 48 | 49 | given() 50 | .contentType(ContentType.JSON) 51 | .body(corpoRequisicao) 52 | .when(). 53 | post(servicoCliente+recursoCliente) 54 | .then() 55 | .statusCode(201) 56 | .assertThat().body(containsString(respostaEsperada)); 57 | 58 | apagaTodosClientesDoServidor(); 59 | } 60 | 61 | @Test 62 | @DisplayName("Quando eu atualizar um cliente, Então ele deve ser atualizado com sucesso") 63 | public void quandoAtualizarCliente_EntaoEleDeveSerAtualizadoComSucesso() { 64 | String corpoOriginalRequisicao = "{\n" + 65 | " \"nome\": \"Vinny\",\n" + 66 | " \"idade\": \"30\",\n" + 67 | " \"id\": \"1234\"\n" + 68 | "}"; 69 | 70 | String corpoAtualizadoRequisicao = "{\n" + 71 | " \"nome\": \"Vinny Pessoni\",\n" + 72 | " \"idade\": \"18\",\n" + 73 | " \"id\": \"1234\"\n" + 74 | "}"; 75 | 76 | String respostaEsperada = "{\"1234\":" + 77 | "{\"nome\":\"Vinny Pessoni\"," + 78 | "\"idade\":18," + 79 | "\"id\":1234," + 80 | "\"risco\":0}" + 81 | "}"; 82 | given() 83 | .contentType(ContentType.JSON) 84 | .body(corpoOriginalRequisicao). 85 | when(). 86 | post(servicoCliente+recursoCliente); 87 | 88 | 89 | given() 90 | .contentType(ContentType.JSON) 91 | .body(corpoAtualizadoRequisicao). 92 | when(). 93 | put(servicoCliente+recursoCliente). 94 | then(). 95 | statusCode(200). 96 | assertThat().body(containsString(respostaEsperada)); 97 | 98 | apagaTodosClientesDoServidor(); 99 | } 100 | 101 | @Test 102 | @DisplayName("Quando eu deletar um cliente, Então ele deve ser removido com sucesso") 103 | public void quandoDeletarCliente_EntaoEleDeveSerDeletadoComSucesso() { 104 | String corpoRequisicao = "{\n" + 105 | " \"nome\": \"Vinny\",\n" + 106 | " \"idade\": \"30\",\n" + 107 | " \"id\": \"1234\"\n" + 108 | "}"; 109 | 110 | String respostaEsperada = "CLIENTE REMOVIDO: { " + 111 | "NOME: Vinny, " + 112 | "IDADE: 30, " + 113 | "ID: 1234 }"; 114 | 115 | given() 116 | .contentType(ContentType.JSON) 117 | .body(corpoRequisicao) 118 | .when(). 119 | post(servicoCliente+recursoCliente); 120 | 121 | given() 122 | .contentType(ContentType.JSON) 123 | .when() 124 | .delete(servicoCliente+recursoCliente+"/1234") 125 | .then() 126 | .statusCode(200) 127 | .assertThat().body(new IsEqual(respostaEsperada)); 128 | } 129 | 130 | /** 131 | * Método de apoio para apagar todos os clientes do servidor. 132 | * Usado para teste apenas. 133 | */ 134 | public void apagaTodosClientesDoServidor(){ 135 | String respostaEsperada = "{}"; 136 | 137 | given() 138 | .contentType(ContentType.JSON) 139 | .when() 140 | .delete(servicoCliente+recursoCliente+apagaTodosClientes) 141 | .then() 142 | .statusCode(200) 143 | .assertThat().body(new IsEqual(respostaEsperada)); 144 | } 145 | } 146 | -------------------------------------------------------------------------------- /gradlew: -------------------------------------------------------------------------------- 1 | #!/usr/bin/env sh 2 | 3 | ############################################################################## 4 | ## 5 | ## Gradle start up script for UN*X 6 | ## 7 | ############################################################################## 8 | 9 | # Attempt to set APP_HOME 10 | # Resolve links: $0 may be a link 11 | PRG="$0" 12 | # Need this for relative symlinks. 13 | while [ -h "$PRG" ] ; do 14 | ls=`ls -ld "$PRG"` 15 | link=`expr "$ls" : '.*-> \(.*\)$'` 16 | if expr "$link" : '/.*' > /dev/null; then 17 | PRG="$link" 18 | else 19 | PRG=`dirname "$PRG"`"/$link" 20 | fi 21 | done 22 | SAVED="`pwd`" 23 | cd "`dirname \"$PRG\"`/" >/dev/null 24 | APP_HOME="`pwd -P`" 25 | cd "$SAVED" >/dev/null 26 | 27 | APP_NAME="Gradle" 28 | APP_BASE_NAME=`basename "$0"` 29 | 30 | # Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script. 31 | DEFAULT_JVM_OPTS='"-Xmx64m"' 32 | 33 | # Use the maximum available, or set MAX_FD != -1 to use that value. 34 | MAX_FD="maximum" 35 | 36 | warn () { 37 | echo "$*" 38 | } 39 | 40 | die () { 41 | echo 42 | echo "$*" 43 | echo 44 | exit 1 45 | } 46 | 47 | # OS specific support (must be 'true' or 'false'). 48 | cygwin=false 49 | msys=false 50 | darwin=false 51 | nonstop=false 52 | case "`uname`" in 53 | CYGWIN* ) 54 | cygwin=true 55 | ;; 56 | Darwin* ) 57 | darwin=true 58 | ;; 59 | MINGW* ) 60 | msys=true 61 | ;; 62 | NONSTOP* ) 63 | nonstop=true 64 | ;; 65 | esac 66 | 67 | CLASSPATH=$APP_HOME/gradle/wrapper/gradle-wrapper.jar 68 | 69 | # Determine the Java command to use to start the JVM. 70 | if [ -n "$JAVA_HOME" ] ; then 71 | if [ -x "$JAVA_HOME/jre/sh/java" ] ; then 72 | # IBM's JDK on AIX uses strange locations for the executables 73 | JAVACMD="$JAVA_HOME/jre/sh/java" 74 | else 75 | JAVACMD="$JAVA_HOME/bin/java" 76 | fi 77 | if [ ! -x "$JAVACMD" ] ; then 78 | die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME 79 | 80 | Please set the JAVA_HOME variable in your environment to match the 81 | location of your Java installation." 82 | fi 83 | else 84 | JAVACMD="java" 85 | which java >/dev/null 2>&1 || die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH. 86 | 87 | Please set the JAVA_HOME variable in your environment to match the 88 | location of your Java installation." 89 | fi 90 | 91 | # Increase the maximum file descriptors if we can. 92 | if [ "$cygwin" = "false" -a "$darwin" = "false" -a "$nonstop" = "false" ] ; then 93 | MAX_FD_LIMIT=`ulimit -H -n` 94 | if [ $? -eq 0 ] ; then 95 | if [ "$MAX_FD" = "maximum" -o "$MAX_FD" = "max" ] ; then 96 | MAX_FD="$MAX_FD_LIMIT" 97 | fi 98 | ulimit -n $MAX_FD 99 | if [ $? -ne 0 ] ; then 100 | warn "Could not set maximum file descriptor limit: $MAX_FD" 101 | fi 102 | else 103 | warn "Could not query maximum file descriptor limit: $MAX_FD_LIMIT" 104 | fi 105 | fi 106 | 107 | # For Darwin, add options to specify how the application appears in the dock 108 | if $darwin; then 109 | GRADLE_OPTS="$GRADLE_OPTS \"-Xdock:name=$APP_NAME\" \"-Xdock:icon=$APP_HOME/media/gradle.icns\"" 110 | fi 111 | 112 | # For Cygwin, switch paths to Windows format before running java 113 | if $cygwin ; then 114 | APP_HOME=`cygpath --path --mixed "$APP_HOME"` 115 | CLASSPATH=`cygpath --path --mixed "$CLASSPATH"` 116 | JAVACMD=`cygpath --unix "$JAVACMD"` 117 | 118 | # We build the pattern for arguments to be converted via cygpath 119 | ROOTDIRSRAW=`find -L / -maxdepth 1 -mindepth 1 -type d 2>/dev/null` 120 | SEP="" 121 | for dir in $ROOTDIRSRAW ; do 122 | ROOTDIRS="$ROOTDIRS$SEP$dir" 123 | SEP="|" 124 | done 125 | OURCYGPATTERN="(^($ROOTDIRS))" 126 | # Add a user-defined pattern to the cygpath arguments 127 | if [ "$GRADLE_CYGPATTERN" != "" ] ; then 128 | OURCYGPATTERN="$OURCYGPATTERN|($GRADLE_CYGPATTERN)" 129 | fi 130 | # Now convert the arguments - kludge to limit ourselves to /bin/sh 131 | i=0 132 | for arg in "$@" ; do 133 | CHECK=`echo "$arg"|egrep -c "$OURCYGPATTERN" -` 134 | CHECK2=`echo "$arg"|egrep -c "^-"` ### Determine if an option 135 | 136 | if [ $CHECK -ne 0 ] && [ $CHECK2 -eq 0 ] ; then ### Added a condition 137 | eval `echo args$i`=`cygpath --path --ignore --mixed "$arg"` 138 | else 139 | eval `echo args$i`="\"$arg\"" 140 | fi 141 | i=$((i+1)) 142 | done 143 | case $i in 144 | (0) set -- ;; 145 | (1) set -- "$args0" ;; 146 | (2) set -- "$args0" "$args1" ;; 147 | (3) set -- "$args0" "$args1" "$args2" ;; 148 | (4) set -- "$args0" "$args1" "$args2" "$args3" ;; 149 | (5) set -- "$args0" "$args1" "$args2" "$args3" "$args4" ;; 150 | (6) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" ;; 151 | (7) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" ;; 152 | (8) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" ;; 153 | (9) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" "$args8" ;; 154 | esac 155 | fi 156 | 157 | # Escape application args 158 | save () { 159 | for i do printf %s\\n "$i" | sed "s/'/'\\\\''/g;1s/^/'/;\$s/\$/' \\\\/" ; done 160 | echo " " 161 | } 162 | APP_ARGS=$(save "$@") 163 | 164 | # Collect all arguments for the java command, following the shell quoting and substitution rules 165 | eval set -- $DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS "\"-Dorg.gradle.appname=$APP_BASE_NAME\"" -classpath "\"$CLASSPATH\"" org.gradle.wrapper.GradleWrapperMain "$APP_ARGS" 166 | 167 | # by default we should be in the correct project dir, but when run from Finder on Mac, the cwd is wrong 168 | if [ "$(uname)" = "Darwin" ] && [ "$HOME" = "$PWD" ]; then 169 | cd "$(dirname "$0")" 170 | fi 171 | 172 | exec "$JAVACMD" "$@" 173 | --------------------------------------------------------------------------------