![]() ![]() ![]() ![]() ![]() ![]() |
This document contains information on the following subjects:
Features of Adobe Flex Builder 2 include:
To install Adobe Flex Builder 2 into Workshop Studio:
<BEA HOME>\tools\eclipse_pkgs\1.0\eclipse_3.2.2\eclipse
Note that Adobe Flex Builder 2 and Flex Charting are only supported on Windows.
As of version 10.1, all of the functionality of WebLogic for Workshop and Workshop Studio have merged into one IDE.
To migrate your applications to the new IDE, see Upgrading to Workshop 10.1.
Workshop 10.1 now supports deployment to these versions of WebLogic Server:
Note: | Note: Facet support for pre-9.2 versions is limited to Struts, JSF, JSP, and Spring. Development of Beehive, Workshop 8.1 runtime, WLS web services and EJBGen are not supported for deployment to pre-9.2 versions. |
Instead of creating one project at a time to build up an application structure, Workshop Quick Start Applications let you create multiple projects simultaneously. Project dependencies are created already in place, as is a WebLogic server configuration. For details see Workshop Quick Start Applications.
Workshop's Ant-based build supports integration with Maven-based build infrastructures.
Workshop version 10.1 is built on the Eclipse Platform, an open source framework that is now widely used for Java development. Workshop extends Eclipse 3.2.2 and the Web Tools Platform 1.5.4.
Workshop for WebLogic is targeted toward the iterative development experience rather than production deployment. As such, a number of features that work correctly in a standalone (development) server environment will not function as expected in a clustered deployment.
Important — Development and testing of applications using this release of Workshop for WebLogic should be done using standalone server environments.
For more information on platform support, including hardware and software requirements, see the Supported Platforms web site.
Updated documentation is available at the Workshop e-docs site.
To comply with the Eclipse Public License, BEA has made source code for derived work available for download at
https://submit-codesamples.projects.dev2dev.bea.com/servlets/Scarab?id=S372
Table 1 lists the known limitations found in Workshop for WebLogic.
If a user selects a version 8.1 domain in the New Server wizard, a hyperlink is displayed to allow user to launch the Domain Upgrader. Upon successfully upgrading the domain, the state of wizard is not refreshed under some circumstances. The old error message on the top of the wizard and the upgrade hyperlink remain, and the Next button is not enabled.
|
|
Javadoc attachments for Workshop libraries can be broken if Workshop for WebLogic is not installed into the default directory under <BEA-HOME>
During installation there is an option to specify the directory into which Workshop is installed. If you specify something other than the default, then the Javadoc for Workshop code such as the service control or timer control cannot be found by the IDE. Thus, actions like Shift-F2 to show the documentation for the classes will not work
Workaround: Add Javadoc attachments to the jars contained in those libraries manually. For example, to add a javadoc attachment to the base Workshop controls jar, go to Windows > Preferences > WebLogic > J2EE Libraries. Select weblogic-controls-1.0 and click Edit. Expand each jar in the Classpath Contribution: tree, right-click the Javadoc location node, and select Edit. Next set the Javadoc location path: to <BEA-HOME>/<your-workshop-dir>/workshop4WP/docs/api, where <your-workshop-dir> is the non-default workshop directory name you entered during install.
|
|
In some cases while debugging an application the source for the JDK classes cannot be found, and will result in a "Source Not Found" page for the class.
Workaround: The workaround is to add a Source attachment manually. This can be done either at the workspace preference level, or if already running a debug session it can be done right there.
If not yet in a debug session, go to the Windows > Preferences > Java > Installed JREs preference page. Select the jdk150_04 JRE and click Edit. Deselect "Use default system libraries" on the Edit JRE dialog. Open the node for rt.jar and select the Source attachment node. Click Edit, then select External File... and navigate to <BEA-HOME>/jrockit90_150_04/ and select src.zip.
|
|
The first time you run Project > Clean after importing a project, Workshop for WebLogic may not clean all of the files from the .apt_src directory
|
|
When generating Xbean types for a Service Control, there are a limited number of situations where the wrapper type from the WSDL is exposed as a type in the Service Control (e.g. when there are multiple occurrences of the same Document type in the same operation signature). If the generated types jar is visible to the target JWS classloader, a duplicate type error will be thrown during deployment.
|
|
When upgrading some .jcx files, the upgrade process may not be able to copy some MBCS characters into the resulting upgraded file. This happens when a WSDL with UTF-8 encoding is inside a file with some other sort of MBCS encoding, like MS932 (Japanese) and MBCS characters appear in that file outside of the WSDL definition.
|
|
When a web service or other artifact is in a web project that is part of more than one EAR, the Run on Server can produce the wrong URL.
|
|
Invocation of buffered Control methods will fail at runtime if deployed (via the IDE) to a server with more than one JMS Server
The IDE will auto-deploy required Workshop libraries when deploying an application. The use of @MessageBuffer on Control methods creates a dependency on application-scoped JMS resources in the weblogic-controls library. If the weblogic-controls library is deployed (by the IDE) to a server with more than one JMS server, the library will deploy, but the application-scoped JMS resources will not be available. This is because the IDE depends on default sub-module targeting, and default sub-module targeting relies on the target containing exactly one JMS Server. A message similar to the following warns that there is an issue with the deployment:
<The JMS module named "WlwRuntimeAppScopedJMS" inside
Note that even though there is a warning message, the library is deployed to the server. This means that applications that are dependent on the library will also successfully deploy. However, invocation of buffered Control methods will fail at runtime with a message similar to the following:
"Failed to invoke end componentFailed to invoke methodMessage |
|
The Perforce Eclipse plugin (P4WSAD) does not add new .prefs files after upgrading an application from version 9.2
Description: When you upgrade a Workshop for WebLogic version 9.2 application the Perforce Pending Changelists view does not show all of the files created in the upgrade process. For example, the com.bea.workshop.wls.core.prefs which replaces the com.bea.wlw.libmodules.core.prefs file is not added to the view.
|
|
When upgrading web applications, the Page Flow Controllers source folder may revert to the default location in some cases
Certain 9.2 web projects with the Beehive NetUI facet may not retain the value of the Associated Files Model settings. Specifically, if such a project has more than one source folder, and the Page Flow Controllers property panel has been set to a source folder other than the default, this value will revert to the default when the project is upgraded.
|
|
Buffered operations on a ServiceControl must be void. However the Message Exchange Pattern (MEP) in the underlying WSDL can be either request/response (with an empty response), or oneway (a request with no response).
In the case of a request/response MEP over JMS, the presence of @MessageBuffer will cause the request to deadlock and eventually timeout. The following warning message will generally be produced:
Potential blocking operation javax.xml.rpc.soap.SOAPFaultException: Failed to receive message java.io.IOException: Request timed out
Workaround: If you can influence the design of the target JWS, having the JWS operation annotated with @Oneway will direct that the underlying MEP be oneway, and will avoid this situation. If you can not influence the design of the target JWS, then the workaround is to add the TransactionAttribute annotation to the ServiceControl operation:
@MessageBuffer |
|
Description: An issue may surface when a 9.2 Beehive application is deployed on WebLogic Server 10.0. The symptom with this scenario is a java.lang.IllegalStateException being thrown. The underlying issue is with the javax.servlet.ServletException which changed from Servlet 2.4 to Servlet 2.5.
Workaround: Upgrade the application to use Beehive 10.0 libraries (which work with either Servlet 2.4 or Servlet 2.5). If the 9.2 application cannot be compiled in 10.0, then manually updating the deployment descriptors in the 9.2 application EAR to use the 10.0 Beehive libraries will resolve this issue. For example:
|
|
Users who upgrade an 8.x application to a 9.x/10.x application may experience issues when making multiple method calls to a JDBC control from a single page flow method
http://download.oracle.com/docs/cd/E13226_01/workshop/docs92/ws_platform/upgrading/conChangesDuringUpgrade.html
Users who upgrade an 8.x application to a 9.x/10.x application may experience issues when making multiple method calls to a JDBC control from a single page flow method. The crux of the issue is that when the first call is made to the JDBC control a new transaction is created by our transaction interceptor. When that call returns the transaction is either committed or rolled back.
On the next call to the JDBC control a new transaction is created, but the JDBC connection being used by the control cannot be used in another transaction (it has been associated as a resource of the first transaction).
The behavior in 8.x page flows was for the JDBC control to release its JDBC connection after each method invocation. The transaction scope for a control method being invoked from a page flow was to start a transaction at the beginning of the control method invocation, and end the transaction on the return of the method. If the control rolled back the transaction, all operations performed within that transaction would be rolled back as well.
|
|
The Web Service stack in WebLogic Server 9.x/10.x does not support nested types as parameters and/or return values. However, Beehive Controls often use inner classes as the pattern for data values (e.g., The JDBC Control contains a commented out example of an inner class to hold the return values from the database queries). Therefore the use of Beehive Control nested values in a JWS is not supported
|
|
When multiple web service controls, with callbacks, have identical class names (ignoring package name) an error will occur in jwsc. This error will appear in the publish step in the ide, during the usable step in exported ant scripts, or when exporting an ear file from the ide. In previous versions of Workshop the exported ant scripts would incorrectly report that the assemble step had succeeded even though this condition was present. This was because the ant script did not attempt to run jwsc on garnered java files.
|
|
Service control generation based on WSDL callbacks named with underscores and numbers can result in incorrect callback method names. This will occur if a lower case letter follows an underscore or number.
a_b a_B javax.xml.rpc.JAXRPCException: SOAPFaultException - FaultCode |
|
NetUI defines implicit objects for use in databinding (e.g., 'backing', 'bundle', 'pageFlow', 'sharedFlow' and 'pageInput'). If a JSF managed bean is created and the name used in the faces-config.xml for that managed bean is the same as the NetUI implicit object names, a runtime FacesException for a bean property could occur. The following is an example that will cause this FacesException:
<managed-bean> |
|
Auto deployment of new J2EE libraries to a 10.0 domain could lead to a class not found during production deployment
In Workshop 10.1, when a user creates a new target runtime which points to a Workshop for WebLogic 10.0 installation, and develops an application against a domain from that installation, Workshop 10.1 will automatically publish newer versions of library jars for all facets in the application, if newer versions exist.
|
|
In moving from a Workshop for WebLogic 10.0 or earlier domain to Workshop version 10.1, you should initiate domain upgrade by using the IDE. This will make the updates to the domain so that you will have the latest runtime binaries for Workshop version 10.1.
If you are managing the domain of an environment that doesn't have the IDE available (for example a platform in which the IDE is not supported or a deployed server) manual upgrade may be required.
beehive-controls-1.0.2.1.ear |
|
Workshop startup.jar cannot be used to run in headless mode on Linux unless an additional system property is defined
|
|
Hibernate JPA projects created in Workshop 10.1 or imported from Workshop Studio 3.x fail to deploy on Weblogic Server 10.0. The below workaround will help Hibernate JPA projects deploy but redeployment will require a server restart
|
|
Manual edits to weblogic.xml and weblogic-application.xml are not automatically reflected in in-memory model
|
|
Linux users who run the domain the upgrader from the IDE will see the following error: "./upgrade.sh -plan=resources/wlw-exec-plan.xml Calling Wizard framework for upgrade: ..."
|
|
Users may experience problems when running HQL queries in the HQL Editor of DBXaminer in a project where both the Hibernate and WebLogic Integrated Commons Logging facets are activated. In this case the Query Result tab will show "weblogic/logging/LogEntry" in the table.
Workaround: Either remove the WebLogic Integrated Commons Logging facet from the project or place an empty commons-logging.properties file in the root of the src directory of the project. Note that this will disable the bridge that integrates Commons Logging with the WebLogic log mechanism, so be sure to re-enable it for deployment by removing the empty commons-logging file or adding back the facet if that functionality is desired.
|
![]() ![]() ![]() |