TeamDev Support : Document List - JExplorer

JExplorer logging

forum-admin@teamdev.com — Thu, 10 Jun 2010 14:27:43 GMT

To enable Log4J logging in JExplorer please use the following steps:

1. Remove slf4j-simple-1.5.8.jar from your application class path

2. Add the slf4j-api-1.5.8.jar, slf4j-log4j12-1.5.8.jar and log4j-1.2.6.jar libraries into your application class path

3. Add the log4j.propertiesfile into your application class path.

JExplorer Technical Questions and Answers

forum-admin@teamdev.com — Thu, 25 Dec 2008 13:50:01 GMT

If you have a question about JExplorer and it is not listed in this FAQ, please send it to us using the support request formand we will add it here after answering to you.

1. Can I embed Internet Explorer into a Swing container? Can I use Internet Explorer without displaying any windows?
Answer: Yes, JExplorer provides both these capabilities. There are two classes: Browser(a Swing component) and HeadlessBrowser(a class for automated testing without GUI).

2. How to get source of the HTML document?
Answer: Load a page using HeadlessBrowserinstance and get the HTML document source by calling the WebBrowser.getContent()method:

WebBrowser browser = new HeadlessBrowser();
browser.navigate("http://google.com");
// Wait until page is loaded completely
browser.waitReady();
String content = browser.getContent();
System.out.println("Source of page: ");
System.out.println(content);

Attached files: CreateHeadlessBrowserSample.java

3. How to embed Internet Explorer into a Swing container?
Answer: Create a Browsercomponent, add it into a Swing container:

Browser browser = new Browser();
 
JFrame frame = new JFrame("JExplorer - Create Browser Sample");
frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
frame.setSize(800, 600);
frame.setLocationRelativeTo(null);
frame.getContentPane().add(browser, BorderLayout.CENTER);
frame.setVisible(true);
 
// Wait when the browser will be ready to work
browser.waitReady();
browser.navigate("http://google.com")

Attached files: CreateBrowserSample.java

4. How to get an element in the HTML document as a Java object?
Answer: The WebBrowser.getDocument()method returns org.w3c.dom.Document object that can be used for finding elements in a document. The code below searches for the submit button by name:

publicvoidexecute(){
...
ElementsearchButton=getSearchButton(browser.getDocument());
}
privatestaticElement
    getSearchButton(org.w3c.dom.Documentdocument){
    org.w3c.dom.NodeListinputs=
        document.getElementsByTagName("input");
    for(inti=0;i<inputs.getLength();i++){
        org.w3c.dom.Elementinput=
(org.w3c.dom.Element)inputs.item(i);
        Stringname=input.getAttribute("name");
        if("btnG".equals(name))
            returninput;
    }
    returnnull;
}

Attached files: SubmitFormSample.java, DomNavigationSample.java

5. How to get/set attributes of an element?
Answer: Find the element in the document and then call the org.w3c.dom.Document.getAttribute() or setAttribute() methods:

Elementlogin=browser.getDocument().getElementById("i1");
// Get an element attribute
Stringtype=login.getAttribute("type");
// Set an element attribute
login.setAttribute("value","john");

Attached files:ElementAttributesSample.java

6. How to navigate to a link in the HTML document?
Answer: Find the link in the page and call the DomRobot.click()method:

ElementgroupsLink=browser.getDocument().getElementById("2a");
if(groupsLink!=null){
DomRobotrobot=newDomRobot(browser);
showMessage("Navigate Groups link");
robot.click(groupsLink);
}

Attached files: NavigateLinkSample.java

7. How to fill the form controls in an HTML document with specified values?
Answer: Find a control in a document, then set the "value" attribute for a text field, "checked" attribute for a checkbox, "selected" attribute for a radio button:

browser.navigate("http://google.com");
browser.waitReady();
// Find a text field in the page
ElementtextInput=getTextInput(browser.getDocument());
textInput.setAttribute("value","JExplorer");

Attached files: SubmitFormSample.java

8. How to submit a form to the server?
Answer: Find a submit button of the form and click the button using the DomRobot.click()method:

ElementsearchButton=getSearchButton(browser.getDocument());
DomRobotrobot=newDomRobot(browser);
robot.click(searchButton);

Attached files: SubmitFormSample.java

9. How to execute JavaScript code?
Answer: Use the Browser.executeScript(String)method:

// Get JavaScript counter variable
Stringcounter=(String)browser.executeScript("counter");
...
// Set JavaScript counter variable
browser.executeScript("counter = 7;");

Attached files: JavascriptSample.java

10. How to listen to events from the document elements in Java code?
Answer: Add an event listener to an element:

privatevoidsetupChangeListener(finalorg.w3c.dom.Elementselect){
    org.w3c.dom.events.EventTargeteventTarget= (org.w3c.dom.events.EventTarget)select;
    eventTarget.addEventListener("onchange",newEventListener(){
        publicvoidhandleEvent(Eventevt){
Elementtarget=(Element)evt.getTarget();
// Gets current value of selected target
Stringvalue=target.getAttribute("value");
            showMessageSwingLoop("Selected product: "+value);
      }
    },false);
}

11. Is there any easy way to find the absolute screen position for a org.w3c.dom.html.HTMLElement ?
Answer: To obtain the absolute screen position of any org.w3c.dom.html.HTMLElement, you will need to cast an instance of such element to the HTMLElementinterface from com.jniwrapper.win32.ie.dompackage and then use its getAbsoluteLocation()method. For example:

HTMLElementhtmlElement=(HTMLElement)element;
Pointpoint=htmlElement.getAbsoluteLocation();

12. Which methods should I use instead of deprecated methods of the DomRobot class?
Answer: The HTMLElement interface contains element-specific methods and HTMLDocument interface contains document-specific methods. The WebBrowser.setSilent(boolean)method enables/disables the error, alert, and confirmation dialogs.

13. Are there any guiding principles to avoid deadlocks in the application that uses JExplorer?
Answer: Don't call the WebBrowser.waitReady()method from Swing or OLE message loop thread.

14. If I work with JExplorer through COM interfaces (native peer objects), I get ComException: COM object method returns error code: 0x80004005; E_FAIL. What's wrong?
Answer: You should work with peer objects in the OLE message loop of the browser. See the chapter " Working with Native Peers and Avoiding Thread Issues" inside JExplorer Programmer's Guide. Otherwise, please refer to the corresponding interface's documentation in MSDN to get know method specific meaning of the error code.

15. When the browser component is visible all of my menus and tooltips seem to show under the browser panel. Can this be fixed?
Answer: To solve this problem, just add the following code to appropriate place in your application:

static
{
JPopupMenu.setDefaultLightWeightPopupEnabled(false);
}

16. I get the following error: ciceroUIWNDFRAME: javaw.exe - apllication error[new]
Answer: This error is not caused by JNIWrapper, but rather by Microsoft Office's Speech and Handwriting Recognition. In order to continue using JNIWrapper, you will need to disable this Microsoft feature. To disable the Speech and Handwriting Recognition:

Click "Start" button at the bottom left of Microsoft Windows.
Click "Control Panel."
Click "Add/Remove Programs."
Click "Microsoft Office."
Click on the "Change" button
Browse to "Office Shared Features."
Click on "Alternative User Input."
For both the Speech and Handwriting Recognition, select "Not available."

Once this is disabled, the CiceroUIWndFrame messages disappear. Also, please check this Microsoft support site for a more detailed set of steps to remove these tools: http://support.microsoft.com/default.aspx?scid=kb;%5BLN%5D;326526.

17. Is it possible for JExplorer to render multiple views into one JFrame?

Answer: Yes it's possible. The sample that demonstrates how to do this you can find here: http://support.teamdev.com/docs/DOC-1184

JExplorer hotfixes

forum-admin@teamdev.com — Mon, 16 Feb 2009 11:50:17 GMT

JExplorer 2.0

2.2.1 Download (Jun 16, 2009)

Fixed issue when the AuthenticationHandler doesn't work correctly on Windows Vista.
Added the HTMLDialog.getOleMessageLoop method that allows receiving a thread in which the modal dialog is running and all COM-related operations with this dialog must be invoked.

2.1.5 Download (Mar 4, 2009)

In the FireEvent functionality added the "Button" property support. Please see the How to fire the onclick event sample.
Fixed issue when an error message dialog is shown on dispose WebBrowser instance in which some PDF document is loaded (Adobe Reader 9 and Windows XP)

2.0.13 Download (Feb 25, 2009)

Fixed issue when proxy settings doesn't work for each WebBrowser instance
Fixed issue when an error message dialog is shown on dispose WebBrowser instance in which some PDF document is loaded (Adobe Reader 9 and Windows XP)

2.0.10 Download (Feb 19, 2009)

Fixed issue when an exception (CO_E_NOTINITIALIZED) occurs during initializing the Robot instance
By default the printing of license info messages in the console is disabled now

2.0.8 Download (Feb 16, 2009)

Fixed issue when JavaScript doesn't work for the iframes on a web page
Enabled the "teamdev.license.info=false" VM option that allows preventing license info messages in the console
Restored the WebBrowser.getDialogEventHandler() and WebBrowser.getAuthenticationHandler() methods

JExplorer Installation Instructions

forum-admin@teamdev.com — Tue, 23 Dec 2008 15:54:55 GMT

Installing Library JAR File

JExplorer uses JNIWrapper, ComfyJ and WinPack products, so all these JAR files (except mshtml.jar) should be in the application class path. The mshtml.jar library is optional and can be used when it is needed to get additional functionality of native MSHTML library.

Native JNIWrapper library (jniwrap.dll) is required for JExplorer and it should be placed in the working directory of a Java application.

Installing License File

The JExplorer library requires valid license file(s): jexplorer.lic, comfyj.lic and jniwrap.lic. License file(s) is not the part of this package and should be obtained separately. Visit TeamDev site (http://www.teamdev.com) to purchase the product or get an evaluation license.

License file(s) has to be installed in the same directory as the native code library or in the META-INF subfolder of any jar library from the application's classpath.

Warning: Do NOT rename the license file or it will not be recognized.

JExplorer 2.0 EAP known issues

roman.kazmin@teamdev.com — Sat, 20 Dec 2008 11:19:01 GMT

Functionality that allows capturing web page is not working
Functionality that allows configure Proxy settings for the current process doesn't work
Print and PrintPreview functionality doesn't work
The KeyFilter functionality is disabled

JExplorer Troubleshooting

roman.kazmin@teamdev.com — Tue, 23 Dec 2008 15:44:31 GMT

1. A valid license is installed, but JExplorer does not load displaying the message "JExplorer license not found."
Cause: The license file is not installed in the same directory with the native code library or its name is incorrect. The license file should be named jexplorer.lic and located in the same directory as the JNIWrapper native library (jniwrap.dll on Win32 or libjniwrap.so on Linux). If any of these conditions is not met JNIWrapper will be unable to find the license file.

Solution: Make sure that the license file is named and placed properly.

2. A valid license jexplorer.lic is installed, but JExplorer does not load displaying the message "JNIWrapper license not found."
Cause: The JNIWrapper license file is not installed in the same directory with the native code library or its name is incorrect.

Solution: Make sure that the license file is named and placed properly.

3. Both JNIWrapper and JExplorer licenses are installed, but JExplorer does not load displaying the message "JNIWrapper license not found. Checked licenses: [..\jexplorer.lic - not valid product]"
Cause: The jexplorer.lic license file is not valid for the product that you use.

Solution: Make sure that you use the correct license for JExplorer product.