TheServices

The Wzz-Bridge Services

• The setup of the Wzz-Bridge Application as described here GettingStarted .
  • Pay particular attention to the "Web Access/Security" section and ensure you have the correct "web.access.tokens" value set.
    • The access token for the below examples is "monkey"
  • The "wzz-bridge" folder exists inside the users home directory.
    • Linux - "/home/username/wzz-bridge"
    • Windows XP - "C:\Documents and Settings\username\wzz-bridge"
    • Vista - "C:\Users\username\wzz-bridge"

Groovy Services

New services can be added dynamically by copying the appropriate Groovy Class or Groovy script file to wzz-bridge/GroovyServiceHome directory.

• Groovy Classes
  Groovy class must implement {{{services.core.commands.execute.SimpleGroovyService}}}

  • wzz-bridge/GroovyServiceHome/HelloClass.groovy

    • http://localhost:8080/wzz-bridge-core/monkey/executeGroovyClass.html?target#HelloWorldClass.groovy&value#World01

  • wzz-bridge/GroovyServiceHome/GetMilliTime.groovy

    • http://localhost:8080/wzz-bridge-core/monkey/executeGroovyClass.html?target#GetMilliTime.groovy&value#

  • wzz-bridge/GroovyServiceHome/GetNanoTime.groovy

    • http://localhost:8080/wzz-bridge-core/monkey/executeGroovyClass.html?target#GetNanoTime.groovy&value#

• '''Groovy Scripts'''
  Only one argument passed in "${argument}", and three values expected to be passed out, which are: "responseCode", "responseMessage", and "responseResult".

  • wzz-bridge/GroovyServiceHome/HelloScript.groovy
    • http://localhost:8080/wzz-bridge-core/monkey/executeGroovyScript.html?target#HelloWorldScript.groovy&value#World01

Java Services

Java classes should have a services.core.commands.SimpleCommandResponse return type for service calls, otherwise the String value of the returned object will be used. New services can be added dynamically by copying the appropriate ".jar" file to the wzz-bridge/JavaServiceHome directory.

• http://localhost:8080/wzz-bridge-core/monkey/executeJava.html?target#java.lang.System.getProperty&value#java.version

Process Services

• http://localhost:8080/wzz-bridge-core/monkey/executeProcess.html?command#java%20-version

Sql Services

You will need to add the appropriate java database library jar to to wzz-bridge/ApplicationHome/lib directory and restart the wzz-bridge for the libraries to become available. (For instance, ojdbc14.jar for Oracle). Additionally you will need to set the correct database values by editing the wzz-bridge/ApplicationHome/application.properties file.

• http://localhost:8080/wzz-bridge-core/monkey/executeSql.html?sqlCommand#Select%201%20from%20dual
  • The optional "jndiName" parameter can also be supplied if the Wzz-Bridge is running inside a container such as Tomcat or JBoss.
  • If the "jndiName" parameter is empty then a value of "default" will be used.

Http Parameter Storage And Retrieval Services

The optional "sessionId" parameter is the unique key that resolves to the clients ip address if not given.

• Store a Parameter
  • http://localhost:8080/wzz-bridge-core/monkey/storeHttpParameters.html?key1#value1
• Retrieve Parameters
  • http://localhost:8080/wzz-bridge-core/monkey/retrieveHttpParameters.html?fetch#.*
• Clear Parameters
  • http://localhost:8080/wzz-bridge-core/monkey/storeHttpParameters.html?action#clear

Property Retrieval Services

This service can response with local or remote properties

• wzz-bridge/PropertyFileHome/default.properties

  • http://localhost:8080/wzz-bridge-core/monkey/fetchPropertiesFromFile.html?propertyFilePath#default.properties&propertyFilter#.*

• java.sun.com/j2se/1.3/font.properties

  • http://localhost:8080/wzz-bridge-core/monkey/fetchPropertiesFromFile.html?propertyFilePath#http://java.sun.com/j2se/1.3/font.properties&propertyFilter#.*

Environment Variable Retrieval Services

• http://localhost:8080/wzz-bridge-core/monkey/fetchEnvironmentVariables.html?environmentVariableFilter#.*

Resource Retrieval Services

• http://localhost:8080/wzz-bridge-core/monkey/resources/sample.txt

• http://localhost:8080/wzz-bridge-core/monkey/resources/app/selenium/extensions/wzz-bridge-extensions.js?resourceContentType#text/plain?resourceContentType#text/plain

  • The optional "resourceContentType" can be supplied