Add example for asserting with java on getting_started/using_selenium (#1672)

* Add example for asserting with java on page getting_started/using_selenium/

Example for Asserting added for java language, by creating AssertionsTest.java
file and adding relevant code lines reference in the markdown file.

* Documentation updated for using_selenium.ja.md

* Add example of Setting up and Tear down with java

Example for Setting up and Tearing down added
for java language, by creating SetupAndTeardownTest.java
file, and adding relevant code lines reference in the markdown file(s).

* Assertion and Setup/Teardown examples linked

Assertion and Setup/Teardown examples linked with
existing UsingSeleniumTest.java, removed AssertionsTest.java
and SetupAndTeardownTest.java

* Do the requested changes

1. BeforeAll and AfterAll functions removed.
2. Print statements removed.
3. driver.manage().window().maximize() removed.
4. Driver navigation and implicit wait code moved into test body.
5. Markdown changes done in all the 4 languages.

[deploy site]

Author: harshitBhardwaj97

examples/java/src/test/java/dev/selenium/getting_started/UsingSeleniumTest.java

@@ -1,38 +1,50 @@
 package dev.selenium.getting_started;
 
+import static org.junit.jupiter.api.Assertions.assertEquals;
+
+import java.time.Duration;
+
+import org.junit.jupiter.api.AfterEach;
+import org.junit.jupiter.api.BeforeEach;
 import org.junit.jupiter.api.Test;
 import org.openqa.selenium.By;
 import org.openqa.selenium.WebDriver;
 import org.openqa.selenium.WebElement;
 import org.openqa.selenium.chrome.ChromeDriver;
 
-import java.time.Duration;
+public class UsingSeleniumTest {
 
-import static org.junit.jupiter.api.Assertions.assertEquals;
+	WebDriver driver;
 
-public class UsingSeleniumTest {
+	@BeforeEach
+	public void setup() {
+		driver = new ChromeDriver();
+	}
+
+	@Test
+	public void eightComponents() {
 
-    @Test
-    public void eightComponents() {
-        WebDriver driver = new ChromeDriver();
-        driver.get("https://www.selenium.dev/selenium/web/web-form.html");
+		driver.manage().timeouts().implicitlyWait(Duration.ofMillis(500));
+		driver.get("https://www.selenium.dev/selenium/web/web-form.html");
 
-        String title = driver.getTitle();
-        assertEquals("Web form", title);
+		String title = driver.getTitle();
+		assertEquals("Web form", title);
 
-        driver.manage().timeouts().implicitlyWait(Duration.ofMillis(500));
+		WebElement textBox = driver.findElement(By.name("my-text"));
+		WebElement submitButton = driver.findElement(By.cssSelector("button"));
 
-        WebElement textBox = driver.findElement(By.name("my-text"));
-        WebElement submitButton = driver.findElement(By.cssSelector("button"));
+		textBox.sendKeys("Selenium");
+		submitButton.click();
 
-        textBox.sendKeys("Selenium");
-        submitButton.click();
+		WebElement message = driver.findElement(By.id("message"));
+		String value = message.getText();
+		assertEquals("Received!", value);
 
-        WebElement message = driver.findElement(By.id("message"));
-        String value = message.getText();
-        assertEquals("Received!", value);
+	}
 
-        driver.quit();
-    }
+	@AfterEach
+	public void teardown() {
+		driver.quit();
+	}
 
 }

website_and_docs/content/documentation/webdriver/getting_started/using_selenium.en.md

@@ -3,20 +3,20 @@ title: "Organizing and Executing Selenium Code"
 linkTitle: "Using Selenium"
 weight: 10
 description: >
-    Scaling Selenium execution with an IDE and a Test Runner library
+  Scaling Selenium execution with an IDE and a Test Runner library
 ---
 
 {{< alert-content >}}
 This page is very incomplete and has placeholders for things that need to be added or expounded on.
 {{< /alert-content >}}
 
-If you want to run more than a handful of one-off scripts, you need to 
+If you want to run more than a handful of one-off scripts, you need to
 be able to organize and work with your code. This page should give you
 ideas for how to actually do productive things with your Selenium code.
 
 ## Common Uses
 
-Most people use Selenium to execute automated tests for web applications, 
+Most people use Selenium to execute automated tests for web applications,
 but Selenium supports any use case of browser automation.
 
 ### Repetitive Tasks
@@ -36,10 +36,9 @@ Running Selenium for testing requires making assertions on actions taken by Sele
 So a good assertion library is required. Additional features to provide structure for tests
 require use of [Test Runner](#test-runners).
 
-
 ## IDEs
 
-Regardless of how you use Selenium code, 
+Regardless of how you use Selenium code,
 you won't be very effective writing or executing it without a good
 Integrated Developer Environment. Here are some common options...
 
@@ -54,10 +53,11 @@ Integrated Developer Environment. Here are some common options...
 ## Test Runner
 
 Even if you aren't using Selenium for testing, if you have advanced use cases, it might make
-sense to use a test runner to better organize your code. Being able to use before/after hooks 
+sense to use a test runner to better organize your code. Being able to use before/after hooks
 and run things in groups or in parallel can be very useful.
 
 ### Choosing
+
 There are many different test runners available.
 
 All the code examples in this documentation can be found in (or is being moved to) our
@@ -67,36 +67,40 @@ that will be used for all examples on this page.
 
 {{< tabpane text=true >}}
 {{% tab header="Java" %}}
+
 - [JUnit](https://junit.org/junit5/) - A widely-used testing framework for Java-based Selenium tests.
 - [TestNG](https://testng.org/) - Offers extra features like parallel test execution and parameterized tests.
-{{% /tab %}}
+  {{% /tab %}}
 
 {{% tab header="Python" %}}
+
 - [pytest](https://pytest.org/) - A preferred choice for many, thanks to its simplicity and powerful plugins.
 - [unittest](https://docs.python.org/3/library/unittest.html) - Python's standard library testing framework.
-{{% /tab %}}
+  {{% /tab %}}
 
 {{% tab header="CSharp" %}}
+
 - [NUnit](https://nunit.org/) - A popular unit-testing framework for .NET.
 - [MS Test](https://docs.microsoft.com/en-us/visualstudio/test/getting-started-with-unit-testing?view=vs-2019) - Microsoft's own unit testing framework.
-{{% /tab %}}
+  {{% /tab %}}
 
 {{% tab header="Ruby" %}}
+
 - [RSpec](https://rspec.info/) - The most widely used testing library for running Selenium tests in Ruby.
 - [Minitest](https://github.com/seattlerb/minitest) - A lightweight testing framework that comes with Ruby standard library.
-{{% /tab %}}
+  {{% /tab %}}
 
 {{% tab header="JavaScript" %}}
+
 - [Jest](https://jestjs.io/) - Primarily known as a testing framework for React, it can also be used for Selenium tests.
 - [Mocha](https://mochajs.org/) - The most common JS library for running Selenium tests.
-{{% /tab %}}
+  {{% /tab %}}
 
 {{% tab header="Kotlin" %}}
 
 {{% /tab %}}
 {{< /tabpane >}}
 
-
 ### Installing
 
 This is very similar to what was required in [Install a Selenium Library]({{< ref "install_library.md" >}}).
@@ -136,7 +140,7 @@ In your project's `package.json`, add requirement to `dependencies`:
 
 {{< tabpane text=true >}}
 {{< tab header="Java" >}}
-{{< badge-code >}}
+{{< gh-codeblock path="examples/java/src/test/java/dev/selenium/getting_started/UsingSeleniumTest.java#L30-L31" >}}
 {{< /tab >}}
 {{% tab header="Python" %}}
 {{< badge-code >}}
@@ -158,20 +162,31 @@ In your project's `package.json`, add requirement to `dependencies`:
 ### Setting Up and Tearing Down
 
 {{< tabpane text=true >}}
-{{< tab header="Java" >}}
-{{< badge-code >}}
-{{< /tab >}}
+{{% tab header="Java" %}}
+
+### Set Up
+
+{{< gh-codeblock path="examples/java/src/test/java/dev/selenium/getting_started/UsingSeleniumTest.java#L19-L22" >}}
+
+### Tear Down
+
+{{< gh-codeblock path="examples/java/src/test/java/dev/selenium/getting_started/UsingSeleniumTest.java#L45-L48" >}}
+
+{{% /tab %}}
 {{% tab header="Python" %}}
 {{< badge-code >}}
 {{% /tab %}}
 {{< tab header="CSharp" >}}
 {{< badge-code >}}
 {{< /tab >}}
 {{% tab header="Ruby" %}}
+
 ### Set Up
+
 {{< gh-codeblock path="examples/ruby/spec/getting_started/using_selenium_spec.rb#L7-L9" >}}
 
 ### Tear Down
+
 {{< gh-codeblock path="examples/ruby/spec/spec_helper.rb#L28" >}}
 {{% /tab %}}
 {{< tab header="JavaScript" >}}
@@ -186,6 +201,7 @@ In your project's `package.json`, add requirement to `dependencies`:
 
 {{< tabpane text=true >}}
 {{% tab header="Java" %}}
+
 ### Maven
 
 ```shell
@@ -209,9 +225,11 @@ gradle clean test
 {{< gh-codeblock path="examples/ruby/README.md#L26" >}}
 {{% /tab %}}
 {{% tab header="JavaScript" %}}
+
 ```shell
 mocha runningTests.spec.js
 ```
+
 {{% /tab %}}
 {{< tab header="Kotlin" >}}
 {{< badge-code >}}
@@ -246,7 +264,7 @@ Here's an example of that code using a test runner:
 
 ## Next Steps
 
-Take what you've learned and build out your Selenium code! 
+Take what you've learned and build out your Selenium code!
 
 As you find more functionality that you need, read up on the rest of our
 [WebDriver documentation]({{< ref "/documentation/webdriver/" >}}).