Java code examples added for various locator types

In this commit i have added the code inside LocatorsTest, for
various types of locators (className, id, xpath), and reffered
that code in the corresponding documentation files.

This commit intends in helping to "move code" for elements -> locators
-> java bindings.

Author: harshitBhardwaj97

examples/java/src/test/java/dev/selenium/elements/LocatorsTest.java

@@ -1,16 +1,105 @@
 package dev.selenium.elements;
-import org.openqa.selenium.By;
-import org.openqa.selenium.support.pagefactory.ByAll;
-import org.openqa.selenium.support.pagefactory.ByChained;
-import dev.selenium.BaseTest;
-import java.util.List;
 
+import dev.selenium.BaseTest;
+import org.openqa.selenium.By;
 import org.openqa.selenium.WebDriver;
 import org.openqa.selenium.WebElement;
 import org.openqa.selenium.chrome.ChromeDriver;
+import org.openqa.selenium.support.pagefactory.ByAll;
+import org.openqa.selenium.support.pagefactory.ByChained;
+
+import java.util.List;
 
 public class LocatorsTest extends BaseTest {
 
+    public void findElementByClassName() {
+        WebDriver driver = new ChromeDriver();
+        driver.get("https://www.selenium.dev/selenium/web/locators_tests/locators.html");
+
+        // Find element by class name
+        WebElement element = driver.findElement(By.className("information"));
+    }
+
+    public void findElementByCssSelector() {
+        WebDriver driver = new ChromeDriver();
+        driver.get("https://www.selenium.dev/selenium/web/locators_tests/locators.html");
+
+        // Find element by css selector
+        WebElement element = driver.findElement(By.cssSelector("#fname"));
+    }
+
+    public void findElementById() {
+        WebDriver driver = new ChromeDriver();
+        driver.get("https://www.selenium.dev/selenium/web/locators_tests/locators.html");
+
+        // Find element by id
+        WebElement element = driver.findElement(By.id("lname"));
+    }
+
+    public void findElementByName() {
+        WebDriver driver = new ChromeDriver();
+        driver.get("https://www.selenium.dev/selenium/web/locators_tests/locators.html");
+
+        // Find element by name
+        WebElement element = driver.findElement(By.name("newsletter"));
+    }
+
+    public void findElementByLinkText() {
+        WebDriver driver = new ChromeDriver();
+        driver.get("https://www.selenium.dev/selenium/web/locators_tests/locators.html");
+
+        // Find element by link text
+        WebElement element = driver.findElement(By.linkText("Selenium Official Page"));
+    }
+
+    public void findElementByPartialLinkText() {
+        WebDriver driver = new ChromeDriver();
+        driver.get("https://www.selenium.dev/selenium/web/locators_tests/locators.html");
+
+        // Find element by partial link text
+        WebElement element = driver.findElement(By.linkText("Official Page"));
+    }
+
+    public void findElementByTagName() {
+        WebDriver driver = new ChromeDriver();
+        driver.get("https://www.selenium.dev/selenium/web/locators_tests/locators.html");
+
+        // Find element by tag name
+        WebElement element = driver.findElement(By.tagName("a"));
+    }
+
+    public void findElementByXpath() {
+        WebDriver driver = new ChromeDriver();
+        driver.get("https://www.selenium.dev/selenium/web/locators_tests/locators.html");
+
+        // Find element by xpath
+        WebElement element = driver.findElement(By.xpath("//input[@value='f']"));
+    }
+
+    public void findElementUsingBy() {
+        WebDriver driver = new ChromeDriver();
+        driver.get("https://www.selenium.dev/selenium/web/locators_tests/locators.html");
+
+        // Define locators using different strategies shared above
+        By informationLocator = By.className("information");
+        By firstNameLocator = By.cssSelector("#fname");
+        By lastNameLocator = By.id("lname");
+        By newsletterLocator = By.name("newsletter");
+        By linkTextLocator = By.linkText("Selenium Official Page");
+        By partialLinkTextLocator = By.partialLinkText("Official Page");
+        By tagNameLocator = By.tagName("a");
+        By xpathLocator = By.xpath("//input[@value='f']");
+
+        // Now we can directly use them in driver.findElement()
+        WebElement informationElement = driver.findElement(informationLocator);
+        WebElement firstNameElement = driver.findElement(firstNameLocator);
+        WebElement lastNameElement = driver.findElement(lastNameLocator);
+        WebElement newsletterElement = driver.findElement(newsletterLocator);
+        WebElement linkTextElement = driver.findElement(linkTextLocator);
+        WebElement partialLinkTextElement = driver.findElement(partialLinkTextLocator);
+        WebElement tagNameElement = driver.findElement(tagNameLocator);
+        WebElement xpathElement = driver.findElement(xpathLocator);
+    }
 
     public void ByAllTest() {
         // Create instance of ChromeDriver