Class Helper$FindDomain

  • public class Helper$FindDomain
extends java.lang.Object
    The contents of the JsonAST-Package are, in general, provided strictly for informational & reference purposes. If further research & investigation of Google's CDP API are necessary, one may deserialize the Browser-API and / or the JavaScript-API from the Java-HTML '.jar' file, and review the AST's programmatically. The AST Node Java-Classes have been meticulously documented exactly for that purpose.

    Generally, though, there really is very little need to review, understand, or programmatically analyze the CDP API. And the contents of this entire package, again, are largely here for reference only.


    This particular class falls under the Package "Sub-Category" known as "The Linker". Linking variables inside of an AST is an extremely simple concept, but has one issue of utmost importance to bear in mind. Converting Google's CDP API from a '.json' definition file (​ browser_protocol.json and js_protocol.json) into an Abstract Syntax Memory inside of Java Program Memory is really all about converting thousands upon thousands of String's into actual POJO References. The Process otherwise known as "Linking" is simply where one class has a "Type" (which in Java is called a "Class") specified by some String into an actual pointer or reference to its definition (another or second "Class") somewhere else on the Java Heap. The Linker merely takes fields defined by strings, and converts them into fields defined by references, no more, no less.

    The only issue to keep in mind, vis-à-vis "The Linker," is that one very common programming technique is to declare fields inside of a class with / using the Java reserved keyword final. However, since fields which need to be "linked" may only be assigned a value after all of the AST Nodes have been constructed, these fields cannot be assigned inside the constructor of an AST Node Class, itself. Therefore, and unfortunately, any field which requires linking cannot be declared final.

    Fields which can be modified (non-final fields), often (but not always), must also be declared private to protect their value from accidental user clobbering or modification. For these reasons, along with others not mentioned, it is much easier to isolate classes for "The Linker", externally into separate Java Class Files.
    This method is used to convert a CDP "domain" (which essentially the same as a Java "Package"), that is represented as a String, and convert it into a reference to one of the Domain object references. Just as a reminder, inside of a Web Browser, a "domain" seems to be extremely similar to the concept of a Java "Package". CDP calls them "domains" instead of packages, and they just group together methods, classes & event classes which are related.

    Essentially this performs:

    Example:
     // The following code would print the string representation of the CDP Domain whose 
 // ==> domain.name.equals("Target");
 
 final Domain d = Helper$FindDomain.find("Target");
 System.out.println(d.toString());


    • Method Summary

      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait