#362 fix

[TikhomirovSergey]

Change list

It is fix of #362. Related issues: #220, #323

Change list:

• the whole content of the the io.appium.java_client.generic.searchcontext was marked @deprecated. It is redundant now.
• some part of Selenium API was added to the project. All the Selenium upstream history was saved.
• the added Selenium API part was modified in required way.
• API improvement.
• code style validation became not so strict.

Types of changes

• Bugfix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)

Details

These changes were supposed to be merged at SeleniumHQ/selenium#863. We are facing the critical issue (may be blocker) now. As soon as the PR is not merged yet and it won't be merged the near future.

Advantages:

• It is possible to use javac compiler when user tries to extend something that included to java_client dependency.

• common Selenium API flexibility (!!!).

It works even if pom is configured like

         <dependency>
            <groupId>io.appium</groupId>
            <artifactId>java-client</artifactId>
            <version>5.0.0-SNAPSHOT</version>
            <exclusions>
                <exclusion>
                    <groupId>org.seleniumhq.selenium</groupId>
                    <artifactId>selenium-java</artifactId>
                </exclusion>
            </exclusions>
        </dependency>
        <dependency>
            <groupId>org.seleniumhq.selenium</groupId>
            <artifactId>selenium-java</artifactId>
            <version>2.52.0</version>
        </dependency>

Disadvantages:

• It is impossible to override List searching methods with javac compiler.

It requires the switching to Eclipse compiler. However it works perfectly in Eclips IDE because it uses that compiler by default.

It is possible to fix this this issue by the adding of modified RemoteWebDriver/RemoteWebElement. But presence of these classes at the java_client bundle is risky.

• it requires to be synchronized with Selenium upstream. Also it requires maintanance of authorship.
  All that is needed till Java: All searching interfaces are made generic SeleniumHQ/selenium#863 or similar change is merged.
  However Selenium API is not frequently changed.

[TikhomirovSergey]

@SrinivasanTarget @bootstraponline
Could you review this PR?

[TikhomirovSergey]

I'm addind snapshot for people who want to test/play around these changes.
5.0.0-SNAPSHOT.zip

[SrinivasanTarget]

@TikhomirovSergey LGTM👍

@simongranger Can you guys have a look on this?