|
|
| |Home | Products | Documents | Downloads | Purchase | Support | Company | Partners | Contact | |
New Peek: Adds a new Peek Kaleidoscope Panel. Note: It pops up a Name Peek Panel for you to specify the name for the new panel first.
New Poke: Adds a new Poke Panel. Note: It pops up a Name Poke Panel for you to specify the name for the new panel first.
Open Peek: Displays a new Peek Kaleidoscope Panel and restores data from previously saved *.peek file. First it will pop up s Name Peek Panel for you to specify the name for a Peek Kaleidoscope Panel, then restore the selected .peek file.
Open Poke: Displays a new Poke Panel and restores data from previously saved *.ejbPoke file. First it will pop up Name Poke Panel for you to specify the name for a Poke Panel, then restore the specified .ejbPoke file.
Refresh JNDI names: Set a flag so when JNDI names are loaded the next time, the loading process will be a complete reloading.
Preference: Displays Preference Panel.
About: Displays version number and license information.
This is an EJB Panel for peeking.
This is an EJB Panel for poking.
This panel allows you to specify the argument list for your method invocation. There are two columns. The left column shows the data type while the right one is for your input from the keyboard.
It is in the order that the method/constructor defined. The number of rows is the same as the number of arguments you need to provide. If the argument list is empty, this panel will not show.
Data types are in two categories: simple data type and non simple data type. Non simple data types are arbitrary objects (except for Vector, Hashtable and alike). The ways to input data is different:
This panel allows you to specify the DynamicArgument class name for the dynamically assigned argument list for EJB constructors or remote methods.
Full class name: The full class name of the DynamicArgument class. This class is a user defined class which implements DynamicArgument interface.
Browse: Displays a FileChooser window for you to select Dynamic Argument class.
Note: If the constructor or remote method has an empty argument list, this panel is not needed and will not show.
This panel allows you to chose input type of argument list for EJB constructors and remote methods.
Keyboard: Input from your keyboard. The input values are static and never change. When the PeekPoke case is saved, the static values will be saved with it too.
Dynamic Argument: Dynamic input from a Java class. You need to specify the full class name. When the method is called the system will call your DynamicArgument class and get the value from it. The value will be assigned to the method to be called. When the PeekPoke case is saved, the DynamicArgument class name will be saved with it too.
Dynamic Argument allows you to assign specified or random argument list for PeekPoking. You need to implement Dynamic Argument classes and put them in your CLASSPATH when you start Acelet-Scheduler on client machine. See Environment variables for more information. Also see DynamicArgument for details.
Note: For EJB constructors, the Dynamic Argument is called once when the EJB is constructed. For remote methods, the Dynamic Argument is called each time the method is called.
Note: If the constructor or remote method has an empty argument list, this panel is not needed and will not show.
Choose a constructor to instantiate your object
Constructor: Lists all available constructors.
If you choose a default constructor (the one with an empty parameter
list), the Object Panel will appear and list
all public fields (attributes) with field names and their data types. Any
arbitrary object is supported (except Vector, Hashtable and alike). If
there are no public fields, you can not use that constructor and an error
message will pop up. If you choose a non default constructor, an Assign
Argument Panel will appear and allow you to specify the argument list.
This panel allows you to choose a destination Peek Panel or Poke Panel for your selected item.
PeekPoke: The list of peek or poke panels available. An name as <New> is for creating new panel. If you choose <New>, then a Name PeekPoke Panel will pop up for you to specify a name.
This panel allows you to specify EJB instance.
Home method: Lists all available home methods for creating or finding an instance EJB.
Input Type - Keyboard: Input from your keyboard. The input values are static and never change. When the PeekPoke case is saved, the static values will be saved with it too.
Input Type - Dynamic Argument: Dynamic input from a Java class. You need to specify the full class name. When the method is called the system will call your DynamicArgument class and get the value from it. The value will be assigned to the method to be called. When the PeekPoke case is saved, the DynamicArgument class name will be saved with it too.
Ok: Creates an instance of EJB using the highlighted home method and closes this panel. If you need to assign an arguments, the Assign Argument Panel will appear for you to do so.
Note: If the constructor or remote method has an empty argument list, this
panel is not needed and will not show.
This panel allows you to edit data of peek or poke items.
Shown name: The item name of the item.
The Info panel is at the top. It shows information about the item. All information on this panel is read only.
The Input panel is in the center. Note: if the item does not require any input, the Input panel will be empty.
Input type: You can use either of the types:
when you choose either of them, the corresponding input field will be available:
Value: The keyboard input value.
Dynamic argument: The full class name of Dynamic Argument.
The button panel is at the bottom. It contains the following buttons:
Invoke: Calls the method using the value or dynamic argument specified.
Close: Closes this panel without doing any thing.
Note: Only applicable GUI components will be visible or enabled.
JNDI name: Shows all available JNDI names from the J2EE server. See JNDI Tree Panel for the whole JNDI tree.
Note: EJB stubs are needed. If your EJB stubs are not on the CLASSPATH, EasyEJB will not list those EJBs. There may be some information about stub-missing EJBs in the file output.txt, depending on the server vender.
Home interface: The Home Interface name of the selected EJB.
Remote interface: The Remote Interface name of the selected EJB.
EJB type: The EJB type of the selected EJB. This ComboBox is disabled. The value can be:
Create: Displays the Define EJB Instance Panel for creating a new instance of EJB
Remote Method: Lists all available remote methods for peeking. The list is for Peek-able methods only. You need to choose one of them for your peeking.
Invoke: Calls the highlighted method immedately.
Add Peek: Adds the highlighted method to a Peek Kaleidoscope Panel, so it can be automatically and repeatedly shown on a Peek Kaleidoscope Panel. A Choose PeekPoke Panel will pop up for you to choose desired panel.
Add Poke: Adds the highlighted method to a Poke Panel, so you can manually call it easily later. A Choose PeekPoke Panel will pop up for you to choose desired panel.
Export peek: Exports the highlighted method to a file, so it can be called later. The file will be saved with extension ejbPeek. The file can be used:
Export poke: Exports it to a file, so it can be called later. The file will be saved with extension ejbPoke. The file can be used:
Close: Closes this panel without doing anything.
Note 1: If the instance of the EJB has not been created, both EJB instance and Remote method boxes are empty.
Note 2: When a Remote method is highlighted, the applicable action buttons will be enabled.
This panel list all available JNDI names as a tree.
This panel allows you to specify the item name for selected item.
Name: The name of your new item. It is for display only.
Name: The name of your new Peek Panel or Poke Panel. You can
specify any name which is meaningful to you.
This panel allows you to specify all public fields (attributes) for an object.
All fields are listed by their names and data types.
Note: The fields listed here are public, not final, not static, not
transient and not volatile. If no field is qualified, this panel will not
show and you will get an error message. If a data type of a field is a
simple
data type, the TextField is editable, you can key in values. Otherwise,
the TextField is not editable. You must press the button which is right
of the TextField to bring a Choose Construct
Panel to instantiate the object. When you are done, the TextField will
show the result string from the object's toString( ) method.
Note: Save and Restore facilities support simple data type only.
The PeekKaleidoscope Panel consists of:
Peek Panel is the main panel. It provides a table view of Peeking and all management functionality for Peeking. The other panels provide different graphical views.
- Peek Panel (table view)
- Time Series Panel (Time Series chart view)
- Pie Panel (Pie chart view)
The Peek Panel is the main panel for Peeking. It is hosted by the Peek Kaleidoscope Panel.
There are two groups of buttons on the toolbar. The first group is related to the selected item, while the second group if for the panel. There is a space between these two groups.
Edit: Displays Edit Data Panel for editing the highlighted item.
Delete: Deletes the highlighted item on the table.
Add: Displays the Add EJB Peek Panel to add a new peek item.
Preference: Displays the Preference Panel to specify attributes.
Refresh: Restarts the peek process.
Stop: Stops the peek process. You can resume it by clicking the Refresh button.
Save: Displays a FileChooser window for you to save the collection of all peek items in a file. The extension of the file will be "peek".
Restore: Displays a FileChooser window for you to restore previously saved peek files. Restored items are added to the current item list. Note: if the name of an item to be restored is taken, the coming item will be ignored.
Rename: Displays Name PeekPoke Panel for renaming this PeekPoke Panel (not an item).
In the middle of the panel, there is a Table Panel, which shows all peek items. There are two columns:
Name: The Peek item name. This is the name you have specified in the Add EJB Peek Panel.
Value: The Peek item value. This is the return value of the peek method. If the return value is an object, toString( ) method is used to print its value.
Snapshot at: Shows the last updated time. This is your local machine
time, not the server's.
All the values will be updated periodically, the interval is specified
by Pace which can be specified on the PeekPreference Panel.
Errors may occur:
1. Time-out error: See Pace for more information.
2. Exception message on value column of the table: An exception was thrown when PeekPoke peeked that particular item.
PeekPoke Lite For JBuilder Install Panel
This is for EasyEJB for JBuilder installation. This is a Lite version of EasyEJB. EasyEJB is a component of Acelet-Scheduler which is a suite of tools for J2EE including SuperEnvironment, SuperLogging, EasyEJB, SuperScheduler, SuperStress and SuperWatchdog. You can find Acelet-Scheduler at www.acelet.com.
EasyEJB is a J2EE tool that allows you to do the following things visually:
No programming is required. Your keyboard is necessary if you want to input values for poking.
This panel appears when you use EasyEJB for the first time.
The GUI components on this panel are very simple:
Server: Lists all supported servers.
Server home: The home directory of your server. For example: on some of our testing machines, the server home directories are:
e:\bea\wlserver6.0
e:\jboss30
e:\WebSphere\AppServer
Note: if you choose Universal, you must:
Note: if you choose Weblogic 6.x: Some distribution of JBuilder 8 has a
file weblogic_initial.config under directory lib/ext. You must remove this file
before you can use EasyEJB Lite. That file points to jar files from
Weblogic 7 and does not match weblogic server 6.x.
This Panel allows you to specify configuration attributes.
Pace: The interval between two peek operations. The unit is one second. It should be greater than 0. The pace should be long enough for PeekPoke to get data within that interval, otherwise, you will get time-out error.
Note: the specified value is a suggested value. The Operating System and Java Virtual Machine may delay it a little bit when they are busy.
This panel shows graphic chart for Peek Items.
Information-tips are available when you move your mouse to a data area and stay there for a second.
Non-number items will not show.
Print: Prints this chart on printer.
There are two groups of buttons on the toolbar. The first group is related to the selected item, while the second group if for the panel. There is a space between these two groups.
Edit: Display Edit Data Panel for editing the highlighted item.
Delete: Deletes the highlighted item on the table.
Invoke: Executes the highlighted item. The Assign Argument Panel will appear if you need to specify your arguments.
Add: Displays the
to add new poke item.
Save: Displays a FileChooser window for you to save the collection of all poke items in a file. The extension of the file will be "poke".
Restore: Displays a FileChooser window for you to restore a previously saved poke file. Restored items are added to the current item list.
Rename: Displays Name PeekPoke Panel for renaming this Poke Panel (not an item).
Nothing will be updated or invoked periodically. You must manually highlight an item and press the Invoke button to invoke it by hand.
When you press the Invoke button, the Return
Value Panel will show the return value of the invocation if the method
returns a value.
This Panel allows you to specify preference for PeekPoke.
EJB info from stub: Specify if EJB information should come from stubs or from remote objects. If this is checked, PeekPoke will get EJB information from stubs. It is usually faster. But you have to put all required stubs in your CLASSPATH. If this is not checked. PeekPoke will get EJB information from remote objects. It is usually slower.
This panel shows the return value of the result from poking.
If it is a simple data type, the result
is shown on the text field and the Detail
button is disabled.
If it is not a simple data type, the result of toString( )
of the object is shown on the text field. You can click on the Detail button
to see detail values of the object.
Simple data type
The following data types are considered as simple data types:
- boolean
- char
- double
- float
- int
- long
- short
- java.lang.String
- java.math.BigDecimal
- java.math.BigInteger
This Panel shows graphic chart for Peek Items.
Information-tips are available when you move your mouse to a data point and stay there for a second.
Non-number items will not show.
Print: Prints this chart on printer.
Preference: Displays the Time Series Preference Panel for setting preferences.
Clear: Clears up this chart and restarts.
This Panel allows you to specify configuration attributes.
Range: The x-axis period on the Time Series chart. The unit is one minute. It should be greater than 0. Data older than this period is discarded.