You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@tomee.apache.org by db...@apache.org on 2018/12/09 02:27:23 UTC
[2/3] tomee git commit: TOMEE-2340 Make all h1, h2,
h3 levels consistent Done via
https://github.com/apache/tomee-site-generator/blob/e1f56acdd154d2a28eedfb996b67bfad646fd14b/src/main/java/org/apache/tomee/website/AsciidocAdjustHeadingLevels.java
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/developer/testing/applicationcomposer/index.adoc
----------------------------------------------------------------------
diff --git a/docs/developer/testing/applicationcomposer/index.adoc b/docs/developer/testing/applicationcomposer/index.adoc
index 64b5e48..2fdd22b 100644
--- a/docs/developer/testing/applicationcomposer/index.adoc
+++ b/docs/developer/testing/applicationcomposer/index.adoc
@@ -6,7 +6,7 @@
ApplicationComposer API is mainly contained in org.apache.openejb.testing package (historically, today we would have called the package org.apache.tomee.applicationcomposer).
-=== Dependencies
+== Dependencies
To start using ApplicationComposer you need to add some dependencies.
@@ -43,9 +43,9 @@ If you need JAXWS services you'll add (or replace thanks to transitivity of mave
</dependency>
----
-=== ApplicationComposer Components
+== ApplicationComposer Components
-==== @Module
+=== @Module
An ApplicationComposer needs at minimum a module (the application you need to deploy).
To do so you have two cases:
@@ -81,7 +81,7 @@ public WebApp app() {
}
----
-==== @Configuration
+=== @Configuration
Often you need to customize a bit the container or at least create some resources like test databases. To do so you can create a method returning Properties which will be the container properties.
Note: to simplify writing properties you can use PropertiesBuilder util class which is just a fluent API to write properties.
@@ -114,7 +114,7 @@ public class MyAppComposer() {
}
----
-==== @Component
+=== @Component
Sometimes you need to customize a container component. The most common use case is the security service to mock a little bit authorization if you don't care in your test.
To do so just write a method decorated with @Component returning the instance you desire.
@@ -129,7 +129,7 @@ public SecurityService mockSecurity() {
}
----
-==== @Descriptors
+=== @Descriptors
You can reuse existing file descriptors using @Descriptors. The name is the file name and the path either a classpath path or a file path:
[source,java]
@@ -143,7 +143,7 @@ public class MyTest {
Note: this can be put in a @Module method as well.
-==== Services
+=== Services
If you want to test a JAXRS or JAXWS service you need to activate these services.
To do so just add the needed dependency and use @EnableServices:
@@ -157,7 +157,7 @@ public class MyTest {
}
----
-==== Random port
+=== Random port
Services like JAXRS and JAXWS relies on HTTP. Often it is nice to have a random port to be able to deploy multiple tests/projects on the same CI platform at the same time.
To shortcut all the needed logic you can use @RandomPort. It is simply an injection giving you either the port (int) or the root context (URL):
@@ -173,13 +173,13 @@ public class MyTest {
Note: you can generate this way multiple ports. The value is the name of the service it will apply on (being said http is an alias for httpejbd which is our embedded http layer).
-==== Nice logs
+=== Nice logs
@SimpleLog annotation allows you to have one liner logs
-==== @JaxrsProvider
+=== @JaxrsProvider
@JaxrsProvider allows you to specify on a @Module method the list of JAXRS provider you want to use.
-==== Dependencies without hacky code
+=== Dependencies without hacky code
@Jars allows you to add dependencies (scanned) to your application automatically (like CDI libraries):
[source,java]
@@ -192,13 +192,13 @@ public WebApp app() {
}
----
-==== @Default
+=== @Default
@Default (openejb one not CDI one) automatically adds in the application target/classes as binaries and src/main/webapp as resources for maven projects.
-==== @CdiExtensions
+=== @CdiExtensions
This annotation allows you to control which extensions are activated during the test.
-==== @AppResource
+=== @AppResource
This annotation allows injection of few particular test resources like:
the test AppModule (application meta)
@@ -206,15 +206,15 @@ the test Context (JNDI)
the test ApplicationComposers (underlying runner)
ContextProvider: allow to mock JAXRS contexts
-==== @MockInjector
+=== @MockInjector
Allows to mock EJB injections. It decorates a dedicated method returning an instance (or Class) implementing FallbackPropertyInjector.
-==== @WebResource
+=== @WebResource
Allow for web application to add folders containing web resources.
-=== How to run it?
-==== JUnit
+== How to run it?
+=== JUnit
If you use JUnit you have mainly 2 solutions to run you "model" using the ApplicationComposer:
using ApplicationComposer runner:
@@ -231,12 +231,12 @@ Tip: since TomEE 7.x ApplicationComposerRule is decomposed in 2 rules if you nee
Finally just write `@Test` method using test class injections as if the test class was a managed bean!
-==== TestNG
+=== TestNG
TestNG integration is quite simple today and mainly ApplicationComposerListener class you can configure as a listener to get ApplicationComposer features.
Finally just write TestNG @Test method using test class injections as if the test class was a managed bean!
-==== Standalone
+=== Standalone
Since TomEE 7.x you can also use ApplicationComposers to directly run you ApplicationComposer model as a standalone application:
[source,java]
@@ -252,7 +252,7 @@ public class MyApp {
Tip: if MyApp has `@PostConstruct` methods they will be respected and if MyApp has a constructor taking an array of String it will be instantiated getting the second parameter as argument (ie you can propagate your main parameter to your model to modify your application depending it!)
-=== JUnit Sample
+== JUnit Sample
[source,java]
----
@@ -273,7 +273,7 @@ public class MyTest {
}
----
-=== Start and Deploy once
+== Start and Deploy once
When having a huge suite of test it can be long to start/deploy/undeploy/shutdown he container/application for each method.
@@ -308,7 +308,7 @@ public class MyTest {
TIP: if you need a real TomEE container then you can have a look to `TomEEEmbeddedSingleRunner` which does deploys the classpath
using tomee-embedded.
-==== Configure what to deploy
+=== Configure what to deploy
As all tests will reuse the same application the model (the class declaring the application with `@Classes`, `@Module` etc...) needs to be extracted from the test class itself.
@@ -321,7 +321,7 @@ If you have several "groups" you can use JUnit `@Category` to differentiate them
in `surefire` plugin you declare two `executions` enforcing the system property `tomee.application-composer.application` for each of them
and the associated `@Category`.
-==== Available injections
+=== Available injections
- If the application model class uses `@RandomPort` then the test classes can get it as well
- CDI injections are supported
@@ -331,5 +331,5 @@ Compared to a standalone usage it misses all other EE injections (`@PersistenceC
and just expose them or wrap them in your tests thanks to the `@Application` field.
-=== Going further
+== Going further
If you want to learn more about ApplicationComposer see link:../../../advanced/applicationcomposer/index.html[ApplicationComposer Advanced] page.
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/developer/testing/arquillian/index.adoc
----------------------------------------------------------------------
diff --git a/docs/developer/testing/arquillian/index.adoc b/docs/developer/testing/arquillian/index.adoc
index 4d44eb3..25be323 100644
--- a/docs/developer/testing/arquillian/index.adoc
+++ b/docs/developer/testing/arquillian/index.adoc
@@ -11,7 +11,7 @@ TomEE has several arquillian adapter flavors:
- tomee-remote: a standard TomEE running in its own process as in production
- tomee-webapp (not recommanded): an adapter starting from a Tomcat and installing tomee-webapp
-=== Embedded or Remote?
+== Embedded or Remote?
Big advantage of embedded adapters is to be able to debug as usual. However it has few drawbacks which can make you
rething this choice:
@@ -28,9 +28,9 @@ to the switch of adapter) on your continuous integration platform.
NOTE: all configurations have defaults
-=== OpenEJB Embedded
+== OpenEJB Embedded
-==== Coordinates
+=== Coordinates
[source,xml]
----
@@ -41,7 +41,7 @@ NOTE: all configurations have defaults
</dependency>
----
-==== arquillian.xml
+=== arquillian.xml
|===
|Name|Description
@@ -74,9 +74,9 @@ Sample:
</arquillian>
----
-=== TomEE Embedded
+== TomEE Embedded
-==== Coordinates
+=== Coordinates
[source,xml]
----
@@ -87,7 +87,7 @@ Sample:
</dependency>
----
-==== Configuration
+=== Configuration
|===
|Name|Description
@@ -178,7 +178,7 @@ Sample:
</arquillian>
----
-=== TomEE Remote
+== TomEE Remote
IMPORTANT: if a server is already started on host:port then it will be used instead of starting the configured TomEE type.
@@ -216,7 +216,7 @@ For really remote instances (= not on localhost) you need the `deployerPropertie
</arquillian>
----
-==== Coordinates
+=== Coordinates
[source,xml]
----
@@ -227,7 +227,7 @@ For really remote instances (= not on localhost) you need the `deployerPropertie
</dependency>
----
-==== Configuration
+=== Configuration
|===
|Name|Description
@@ -352,7 +352,7 @@ Sample:
</arquillian>
----
-=== Multiple instances
+== Multiple instances
With arquillian you can create cluster or isolated instances. Here is a sample `arquillian.xml`:
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/developer/testing/other/index.adoc
----------------------------------------------------------------------
diff --git a/docs/developer/testing/other/index.adoc b/docs/developer/testing/other/index.adoc
index b1d41b1..a749c0b 100644
--- a/docs/developer/testing/other/index.adoc
+++ b/docs/developer/testing/other/index.adoc
@@ -4,14 +4,14 @@
:jbake-status: published
:jbake-tomeepdf:
-=== EJBContainer
+== EJBContainer
The `EJBContainer` API is a JavaEE API enriched by some OpenEJB features to make the testing easier.
It starts a container (embedded for case we are interested in) scanning the classpath. This operation can be
slow and if you go with this solution maybe think to start it only once for all tests.
-==== Sample
+=== Sample
[source,java]
----
@@ -70,11 +70,11 @@ It will use `createEJBContainer()` method to start the container and application
OpenEJB provides the `bind("inject")` hack to be able to get injection in the test class.
-=== OpenEJB JUnit
+== OpenEJB JUnit
`openejb-junit` is another artifact providing some facilities for testing.
-==== EJBContainer Rule
+=== EJBContainer Rule
[source,java]
----
@@ -106,7 +106,7 @@ public class TestEJBContainerDefaultConfig {
TIP: there is the equivalent runner: `@RunWith(EJBContainerRunner.class)`
-==== InjectRule: injections for EJBContainerRule
+=== InjectRule: injections for EJBContainerRule
[source,java]
----
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/developer/tools/maven/applicationcomposer.adoc
----------------------------------------------------------------------
diff --git a/docs/developer/tools/maven/applicationcomposer.adoc b/docs/developer/tools/maven/applicationcomposer.adoc
index 05bb4b0..37606a8 100644
--- a/docs/developer/tools/maven/applicationcomposer.adoc
+++ b/docs/developer/tools/maven/applicationcomposer.adoc
@@ -12,7 +12,7 @@ This plugin has two goal:
IMPORTANT: the dependencies are retrieved with `MavenProject.getArtifacts()` which means you artifacts should be a `war`
- maven doesn't populate it with a `jar` - and the compile phase - at least - should be passed to ensure it is populated.
-=== Run goal configuration
+== Run goal configuration
[source,bash]
----
@@ -28,7 +28,7 @@ mvn process-classes applicationcomposer:run -DskipTests
|mavenLog|true|force to use maven logging in openejb
|===
-=== Zip goal configuration
+== Zip goal configuration
[source,bash]
----
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/developer/tools/maven/embedded.adoc
----------------------------------------------------------------------
diff --git a/docs/developer/tools/maven/embedded.adoc b/docs/developer/tools/maven/embedded.adoc
index 6e27054..780b97b 100644
--- a/docs/developer/tools/maven/embedded.adoc
+++ b/docs/developer/tools/maven/embedded.adoc
@@ -6,7 +6,7 @@
TomEE Embedded Maven plugin has a single goal: `tomee-embedded:run`.
-=== Configuration
+== Configuration
[.table.table-bordered,options="header"]
|===
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/developer/tools/maven/tomee.adoc
----------------------------------------------------------------------
diff --git a/docs/developer/tools/maven/tomee.adoc b/docs/developer/tools/maven/tomee.adoc
index 44ab4f4..a635b73 100644
--- a/docs/developer/tools/maven/tomee.adoc
+++ b/docs/developer/tools/maven/tomee.adoc
@@ -18,7 +18,7 @@ TomEE Maven Plugin is a set of goals for the development and to prepare to go in
- `tomee:stop`
- `tomee:undeploy`
-=== Run
+== Run
The most commonly used goal, it allows to start a tomee with applications. Here is its configuration:
@@ -95,7 +95,7 @@ Synchronization are blocks defining a source and target folder and both are sync
`src/main/webapp` resources in `target/apache-tomee/webapps/myapp/`.
-==== Customizers
+=== Customizers
Customizers are java classes loadable by the plugin and with a main or implementing `Runnable` and taking optionally
as constructor parameter a `File` representing `tomee.base` or no arguments.
@@ -107,7 +107,7 @@ There are two scripting flavors of that: js and groovy. Both will have some cont
- catalinaBase: tomee base path
- resolver: a maven resolver to get a dependency using maven. For instance: `resolver.resolve('group', 'artfact', 'version', 'type')`
-==== Dependencies (libs)
+=== Dependencies (libs)
The format can be:
@@ -132,7 +132,7 @@ unzip:groupId:artifactId:version
remove:prefix
----
-==== Example
+=== Example
[source,xml]
----
@@ -165,7 +165,7 @@ remove:prefix
</plugin>
----
-=== Build
+== Build
Excepted synchronization, build plugin inherit from `run` Mojo its configuration. It just adds the following:
@@ -178,6 +178,6 @@ Excepted synchronization, build plugin inherit from `run` Mojo its configuration
|skipArchiveRootFolder|false|don't add a root folder in the zip
|===
-=== Tomcat like goals
+== Tomcat like goals
`configtest`, `start` and `stop` just execute these commands on the server (like on `catalina.sh`).
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/docs.adoc
----------------------------------------------------------------------
diff --git a/docs/docs.adoc b/docs/docs.adoc
index 141c662..9d8c221 100644
--- a/docs/docs.adoc
+++ b/docs/docs.adoc
@@ -4,12 +4,12 @@
:jbake-status: published
:jbake-tomeepdf:
-=== Administration
+== Administration
- link:admin/configuration/index.html[Server Configuration]
- link:admin/directory-structure.html[Directory Structure]
- link:admin/cluster/index.html[Clustering and High Availability (HA)]
-=== Developers
+== Developers
- link:developer/ide/index.html[IDEs - Eclipse, Intellij Idea and Netbeans]
- link:developer/testing/index.html[Unit Testing - Arquillian, OpenEJB JUnit, TomEE Embedded and ApplicationComposer]
- link:developer/tools/index.html[Build Tools and Plugins]
@@ -18,7 +18,7 @@
- link:developer/configuration/cxf.html[Apache CXF Configuration - JAX-RS (RESTful Services) and JAX-WS (Web Services)]
- link:developer/classloading/index.html[Understanding the TomEE ClassLoader]
-=== Advanced
+== Advanced
- link:advanced/applicationcomposer/index.html[`ApplicationComposer` with JBatch]
- link:advanced/setup/index.html[How to Setup TomEE in Production]
- link:advanced/shading/index.html[Fat / Uber Jar Deployment using the Maven Shade Plugin]
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/documentation.adoc
----------------------------------------------------------------------
diff --git a/docs/documentation.adoc b/docs/documentation.adoc
index c3baa94..d7c7bf9 100644
--- a/docs/documentation.adoc
+++ b/docs/documentation.adoc
@@ -1,4 +1,4 @@
-# Documentation
+= Documentation
:index-group: Unrevised
:jbake-date: 2018-12-05
:jbake-type: page
@@ -19,7 +19,7 @@ link:getting-started-with-eclipse-and-webby.html[Get started with
Eclipse (m2e-Webby)] +
link:tomee-and-netbeans.html[Get started with Netbeans]
-###General Informations link:comparison.html[Comparison: OpenEJB, TomEE,
+== General Informations link:comparison.html[Comparison: OpenEJB, TomEE,
TomEE+] +
link:tomee-directory-structure.html[TomEE Directory structure] +
link:deploying-in-tomee.html[Deploying in TomEE] +
@@ -70,7 +70,7 @@ link:multipoint-recommendations.html[Multipoint Recommendations] +
link:failover-logging.html[Logging Events] +
} \{span-one-third
-###OpenEJB Standalone Server
+== OpenEJB Standalone Server
link:understanding-the-directory-layout.html[Understanding the Directory
Layout] +
link:startup.html[Startup] +
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/documentation.old.adoc
----------------------------------------------------------------------
diff --git a/docs/documentation.old.adoc b/docs/documentation.old.adoc
index c7fe243..41c447c 100644
--- a/docs/documentation.old.adoc
+++ b/docs/documentation.old.adoc
@@ -14,7 +14,7 @@ link:getting-started-with-eclipse-and-webby.html[Get started with
Eclipse (m2e-Webby)] +
link:tomee-and-netbeans.html[Get started with Netbeans]
-###General Informations link:comparison.html[Comparison: OpenEJB, TomEE,
+= General Informations link:comparison.html[Comparison: OpenEJB, TomEE,
TomEE+] +
link:tomee-directory-structure.html[TomEE Directory structure] +
link:deploying-in-tomee.html[Deploying in TomEE] +
@@ -65,7 +65,7 @@ link:multipoint-recommendations.html[Multipoint Recommendations] +
link:failover-logging.html[Logging Events] +
} \{span-one-third
-###OpenEJB Standalone Server
+= OpenEJB Standalone Server
link:understanding-the-directory-layout.html[Understanding the Directory
Layout] +
link:startup.html[Startup] +
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/dynamic-datasource.adoc
----------------------------------------------------------------------
diff --git a/docs/dynamic-datasource.adoc b/docs/dynamic-datasource.adoc
index c2d519a..e5e63fa 100644
--- a/docs/dynamic-datasource.adoc
+++ b/docs/dynamic-datasource.adoc
@@ -1,10 +1,10 @@
-# Dynamic Datasource
+= Dynamic Datasource
:index-group: Unrevised
:jbake-date: 2018-12-05
:jbake-type: page
:jbake-status: published
-# OpenEJB dynamic datasource
+= OpenEJB dynamic datasource
== Goal
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/eclipse-plugin.adoc
----------------------------------------------------------------------
diff --git a/docs/eclipse-plugin.adoc b/docs/eclipse-plugin.adoc
index 5bf8e39..4aa12dc 100644
--- a/docs/eclipse-plugin.adoc
+++ b/docs/eclipse-plugin.adoc
@@ -1,10 +1,10 @@
-# Eclipse Plugin
+= Eclipse Plugin
:index-group: Unrevised
:jbake-date: 2018-12-05
:jbake-type: page
:jbake-status: published
-# What is it?
+= What is it?
The _OpenEJB Eclipse Plugin_ will be a suite of tools made available via
Eclipse to make EJB development with OpenEJB easier. The initial
@@ -15,7 +15,7 @@ and Eclipse project integration. From there, the sky is the limit so
feel free to suggest features on the [OpenEJB Dev list|Mailing
Lists#MailingLists-DeveloperMailingList] .
-# How to get involved?
+= How to get involved?
Just the same as getting involved with any part of OpenEJB -- send a
mail to the
@@ -23,19 +23,19 @@ link:mailing-lists#mailinglists-developermailinglist.html[OpenEJB Dev
list] and say "Hi!" We're a very relaxed group so no need to be perfect
or overly prepared. Just dive right in, we're always happy to have more.
-# Where do I get it?
+= Where do I get it?
The initiative is just launching, but you can grab what we have right
here and start hacking.
http://svn.apache.org/repos/asf/tomee/openejb-eclipse-plugin/trunk/
-# What do I need to help?
+= What do I need to help?
http://www.eclipse.org[Eclipse] http://www.eclipse.org/webtools[Eclipse
Web Tools]
-# Resources
+= Resources
http://eclipsezilla.eclipsecon.org/show_bug.cgi?id=3581[EclipseCon
Presentation for Extending WTP]
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/ejb-failover.adoc
----------------------------------------------------------------------
diff --git a/docs/ejb-failover.adoc b/docs/ejb-failover.adoc
index de4cd50..0b896c2 100644
--- a/docs/ejb-failover.adoc
+++ b/docs/ejb-failover.adoc
@@ -1,4 +1,4 @@
-# EJB Client/Server Failover
+= EJB Client/Server Failover
:index-group: Discovery and Failover
:jbake-date: 2018-12-05
:jbake-type: page
@@ -75,7 +75,7 @@ will broadcast all it's services with the group prefixed in the URI, as
well it will ignore any services it sees broadcast if they do not share
the same group name.
-#Details
+= Details
Multicast
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/ejb-local-ref.adoc
----------------------------------------------------------------------
diff --git a/docs/ejb-local-ref.adoc b/docs/ejb-local-ref.adoc
index 648b433..eb6685e 100644
--- a/docs/ejb-local-ref.adoc
+++ b/docs/ejb-local-ref.adoc
@@ -1,10 +1,10 @@
-# ejb-local-ref
+= ejb-local-ref
:index-group: Unrevised
:jbake-date: 2018-12-05
:jbake-type: page
:jbake-status: published
-# Via annotation
+= Via annotation
Usable by EJB, Interceptor, Servlet, Filter, or Listener
@@ -34,7 +34,7 @@ public class MyEjbLocalRefBean implements MyBeanInterface {
}
----
-# Via xml
+= Via xml
The above @EJB annotation usage is 100% equivalent to the following xml.
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/ejb-over-ssl.adoc
----------------------------------------------------------------------
diff --git a/docs/ejb-over-ssl.adoc b/docs/ejb-over-ssl.adoc
index 431441a..aeea493 100644
--- a/docs/ejb-over-ssl.adoc
+++ b/docs/ejb-over-ssl.adoc
@@ -1,4 +1,4 @@
-# EJB over SSL
+= EJB over SSL
:index-group: Configuration
:jbake-date: 2018-12-05
:jbake-type: page
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/ejb-ref.adoc
----------------------------------------------------------------------
diff --git a/docs/ejb-ref.adoc b/docs/ejb-ref.adoc
index f87de2f..61402d3 100644
--- a/docs/ejb-ref.adoc
+++ b/docs/ejb-ref.adoc
@@ -1,10 +1,10 @@
-# ejb-ref
+= ejb-ref
:index-group: Unrevised
:jbake-date: 2018-12-05
:jbake-type: page
:jbake-status: published
-#
+=
Via annotation
[source,java]
@@ -33,7 +33,7 @@ public class MyEjbRemoteRefBean implements MyBeanInterface {
}
----
-# Via xml
+= Via xml
The above @EJB annotation usage is 100% equivalent to the following xml.
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/ejb-refs.adoc
----------------------------------------------------------------------
diff --git a/docs/ejb-refs.adoc b/docs/ejb-refs.adoc
index cfa5379..8ca87ee 100644
--- a/docs/ejb-refs.adoc
+++ b/docs/ejb-refs.adoc
@@ -1,4 +1,4 @@
-# EJB Refs
+= EJB Refs
:index-group: Unrevised
:jbake-date: 2018-12-05
:jbake-type: page
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/ejb-request-logging.adoc
----------------------------------------------------------------------
diff --git a/docs/ejb-request-logging.adoc b/docs/ejb-request-logging.adoc
index 6f65625..2348db2 100644
--- a/docs/ejb-request-logging.adoc
+++ b/docs/ejb-request-logging.adoc
@@ -1,4 +1,4 @@
-# EJB Request Logging
+= EJB Request Logging
:index-group: Unrevised
:jbake-date: 2018-12-05
:jbake-type: page
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/ejbd-transport.adoc
----------------------------------------------------------------------
diff --git a/docs/ejbd-transport.adoc b/docs/ejbd-transport.adoc
index 4d0cd79..1b99f58 100644
--- a/docs/ejbd-transport.adoc
+++ b/docs/ejbd-transport.adoc
@@ -1,4 +1,4 @@
-# Ejbd Transport
+= Ejbd Transport
:index-group: EJB
:jbake-date: 2018-12-05
:jbake-type: page
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/embedded-and-remotable.adoc
----------------------------------------------------------------------
diff --git a/docs/embedded-and-remotable.adoc b/docs/embedded-and-remotable.adoc
index 982a3fd..ace1613 100644
--- a/docs/embedded-and-remotable.adoc
+++ b/docs/embedded-and-remotable.adoc
@@ -1,10 +1,10 @@
-# Embedded and Remotable
+= Embedded and Remotable
:index-group: Unrevised
:jbake-date: 2018-12-05
:jbake-type: page
:jbake-status: published
-# Overview
+= Overview
This example shows how to use OpenEJB3's remoting capabilities in an
embedded scenario. By remoting we mean that you wish to allow _clients
@@ -51,7 +51,7 @@ for network sockets. This example shows the use of OpenEJB in an
embedded environment where connection _outside_ the vm is
required.\{note}
-# The Code
+= The Code
For this example we have a simple Stateful bean called TelephoneBean as
defined below. As a simple way of demonstrating the state we have to
@@ -78,7 +78,7 @@ rules change and require that you specify both interfaces in the @Remote
annotation as in @Remote(\{Telephone.class, SecondInterface.class}).
\{tip}
-# Embedding
+= Embedding
We're going to embed OpenEJB3 into a plain JUnit TestCase as a simple
means of demonstrating the remote capabilities. We'll do the embedding
@@ -111,13 +111,13 @@ like any other remote EJB client.
\{snippet:id=remotecontext|url=openejb3/examples/telephone-stateful/src/test/java/org/superbiz/telephone/TelephoneTest.java|lang=java}
-# Maven setup
+= Maven setup
\{snippet:id=desc|url=openejb3/examples/telephone-stateful/pom.xml}
\{snippet:id=openejbdep|url=openejb3/examples/telephone-stateful/pom.xml|lang=xml}
-# Running
+= Running
Running the example is fairly simple. In the "telephone-stateful"
directory of the openejb:download.html[examples zip] , just run:
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/embedded-configuration.adoc
----------------------------------------------------------------------
diff --git a/docs/embedded-configuration.adoc b/docs/embedded-configuration.adoc
index a0ef648..8f859db 100644
--- a/docs/embedded-configuration.adoc
+++ b/docs/embedded-configuration.adoc
@@ -1,11 +1,11 @@
-# OpenEJB Embedded Configuration
+= OpenEJB Embedded Configuration
:index-group: Testing Techniques
:jbake-date: 2018-12-05
:jbake-type: page
:jbake-status: published
-# Defaults, Overrides and Order
+= Defaults, Overrides and Order
When booting up OpenEJB for testing via the `LocalInitialContextFactory`
or the newer `EJBContainer.createEJBContainer()` API part of EJB 3.1
@@ -44,7 +44,7 @@ InitialContext properties. You can put 100% of your configuration in a
You can manage the properties how you wish and there is no need for
redundant definitions if you do not want them.
-# What is configurable?
+= What is configurable?
Everything you can configure via an openejb.xml (minus the element) can
be configured/overridden via properties. See
@@ -64,7 +64,7 @@ PersistenceUnits in Tests].
OpenEJB has many flags that can also be set as properties. See
link:properties-listing.html[OpenEJB Properties] for details on those.
-# Example of using InitialContext properties
+= Example of using InitialContext properties
[source,java]
----
@@ -94,7 +94,7 @@ p.put("openejb.validation.output.level ", " verbose");
InitialContext initialContext = new InitialContext(p);
----
-# Example of using jndi.properties
+= Example of using jndi.properties
Here's an example of the same properties being specified via a
`jndi.properties file`. This file just needs to be placed in the
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/embedding.adoc
----------------------------------------------------------------------
diff --git a/docs/embedding.adoc b/docs/embedding.adoc
index 516826d..90958f6 100644
--- a/docs/embedding.adoc
+++ b/docs/embedding.adoc
@@ -1,4 +1,4 @@
-# Embedding
+= Embedding
:index-group: Unrevised
:jbake-date: 2018-12-05
:jbake-type: page
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/faq.adoc
----------------------------------------------------------------------
diff --git a/docs/faq.adoc b/docs/faq.adoc
index a841956..74f94ea 100644
--- a/docs/faq.adoc
+++ b/docs/faq.adoc
@@ -1,10 +1,10 @@
-# FAQ
+= FAQ
:index-group: Unrevised
:jbake-date: 2018-12-05
:jbake-type: page
:jbake-status: published
-##
+==
General
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/features.adoc
----------------------------------------------------------------------
diff --git a/docs/features.adoc b/docs/features.adoc
index 0127038..e9d394d 100644
--- a/docs/features.adoc
+++ b/docs/features.adoc
@@ -1,4 +1,4 @@
-# Features
+= Features
:index-group: Unrevised
:jbake-date: 2018-12-05
:jbake-type: page
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/from-glassfish-to-tomee.adoc
----------------------------------------------------------------------
diff --git a/docs/from-glassfish-to-tomee.adoc b/docs/from-glassfish-to-tomee.adoc
index 2e1dcc9..aa3c339 100644
--- a/docs/from-glassfish-to-tomee.adoc
+++ b/docs/from-glassfish-to-tomee.adoc
@@ -4,7 +4,7 @@
:jbake-status: published
-# From Glassfish
+= From Glassfish
Application Server to TomEE (plus)
This page aims at reporting feedback from users while migrating from
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/functional-testing-with-openejb,-jetty-and-selenium.adoc
----------------------------------------------------------------------
diff --git a/docs/functional-testing-with-openejb,-jetty-and-selenium.adoc b/docs/functional-testing-with-openejb,-jetty-and-selenium.adoc
index 740c932..fafe885 100644
--- a/docs/functional-testing-with-openejb,-jetty-and-selenium.adoc
+++ b/docs/functional-testing-with-openejb,-jetty-and-selenium.adoc
@@ -1,4 +1,4 @@
-# Functional testing with OpenEJB, Jetty and Selenium
+= Functional testing with OpenEJB, Jetty and Selenium
:index-group: Testing Techniques
:jbake-date: 2018-12-05
:jbake-type: page
@@ -17,7 +17,7 @@ a test, and functionally test it with a tool like Selenium. There's also
some sample code demonstrating this, available
http://people.apache.org/~jgallimore/PersonApp.zip[here] .
-=== Creating an embedded server
+== Creating an embedded server
I created a class to start my embedded OpenEJB and Jetty instances and
configure them to see the EJB and WAR modules of my application:
@@ -133,7 +133,7 @@ using the java:comp/env/bean format. I've added a main() method here for
convenience, so you can run this straight from an IDE, and record tests
using tools like the Selenium Firefox plugin.
-=== Supporting @EJB Dependency injection
+== Supporting @EJB Dependency injection
In the last code sample, we also set up a custom ServletHandler in Jetty
- this is to perform dependency injection. The custom ServletHandler
@@ -195,7 +195,7 @@ annotations = declaredField.getAnnotations();
This looks up deployed beans that match the field type, and uses
reflection to set the field.
-=== Writing a Functional test
+== Writing a Functional test
We can now write a functional test. I use a base abstract class to make
sure the Embedded server is running, and start Selenium:
@@ -239,7 +239,7 @@ public class AddPersonTest extends FunctionalTestCase {
}
----
-=== Sample code
+== Sample code
I've made a sample project which demonstrates this, source is available
http://people.apache.org/~jgallimore/PersonApp.zip[here] . You'll need
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/generating-ejb-3-annotations.adoc
----------------------------------------------------------------------
diff --git a/docs/generating-ejb-3-annotations.adoc b/docs/generating-ejb-3-annotations.adoc
index d56e48c..ac06f3f 100644
--- a/docs/generating-ejb-3-annotations.adoc
+++ b/docs/generating-ejb-3-annotations.adoc
@@ -1,10 +1,10 @@
-# Generating EJB 3 annotations
+= Generating EJB 3 annotations
:index-group: Unrevised
:jbake-date: 2018-12-05
:jbake-type: page
:jbake-status: published
-# Generating EJB 3 annotations
+= Generating EJB 3 annotations
The OpenEJB Eclipse plugin is able to provide some assistance in helping
you migrate EJB 2.x projects to EJB 3.0, by analyzing your ejb-jar.xml
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/getting-started.adoc
----------------------------------------------------------------------
diff --git a/docs/getting-started.adoc b/docs/getting-started.adoc
index e67e0b0..60c205f 100644
--- a/docs/getting-started.adoc
+++ b/docs/getting-started.adoc
@@ -1,10 +1,10 @@
-# Getting Started
+= Getting Started
:index-group: Unrevised
:jbake-date: 2018-12-05
:jbake-type: page
:jbake-status: published
-##The following instructions are written using Eclipse 3.2. We
+== The following instructions are written using Eclipse 3.2. We
will refer to the install location of OpenEJB as OPENEJB_HOME
Here are some basic steps you need to perform to get started with
@@ -12,14 +12,14 @@ OpenEJB 1. Download and install OpenEJB 1. Setup your development
environment 1. Write an EJB 1. Write an EJB client 1. Start the server
1. Deploy the EJB 1. Run the client 1. Stop the server
-##1. Download and Install OpenEJB
+== 1. Download and Install OpenEJB
Follow
these http://cwiki.apache.org/confluence/display/OPENEJB/Quickstart[instructions]
-##2. Setup your development environment
+== 2. Setup your development environment
-###Eclipse
+=== Eclipse
* Open eclipse and create a new java project. Name it EJBProject
* Add the following jars to the build path of your project --
@@ -30,7 +30,7 @@ write a test client
OPENEJB_HOME/lib/openejb-client-3.0.0-SNAPSHOT.jar
* Add the EJBProject to the classpath of the EJBClient project
-##3. Start the Server
+== 3. Start the Server
Open the command prompt and run the following command:
@@ -60,7 +60,7 @@ OpenEJB ready.
Ready!
----
-##4. Write an EJB
+== 4. Write an EJB
In the EJB project create a new interface named Greeting
@@ -125,7 +125,7 @@ App(id=D:\openejb-3.0.0-SNAPSHOT\apps\greeting.jar)
information. Keep this handy as this is the JNDI name of the bean which
the client will use for lookup\{_}\{color}
-##6. Write the Client
+== 6. Write the Client
In the EJBClient project, create a class named Client (shown below)
@@ -156,7 +156,7 @@ public class Client {
}
----
-##7. Run the Client
+== 7. Run the Client
Open Client.java in eclipse and run it as a java application. You should
see the following message in the console view:
@@ -166,7 +166,7 @@ see the following message in the console view:
My First Remote Stateless Session Bean
----
-##8. Stop the server
+== 8. Stop the server
There are two ways to stop the server: 1. You can press Ctrl+c on the
command prompt to stop the server 1. On the command prompt type in the
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/hello-world.adoc
----------------------------------------------------------------------
diff --git a/docs/hello-world.adoc b/docs/hello-world.adoc
index 51df195..f8a9214 100644
--- a/docs/hello-world.adoc
+++ b/docs/hello-world.adoc
@@ -1,4 +1,4 @@
-# Hello World
+= Hello World
:index-group: Unrevised
:jbake-date: 2018-12-05
:jbake-type: page
@@ -257,7 +257,7 @@ Hello World!!!!
Just send us an email at users@tomee.apache.org. If possible, send us
the contents of logs/openejb.log file in the email.
-# Looking for more?
+= Looking for more?
More EJB 3.0 examples, sample applications, tutorials and howtos
available link:examples.html[here] .
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/hibernate.adoc
----------------------------------------------------------------------
diff --git a/docs/hibernate.adoc b/docs/hibernate.adoc
index 9217adf..ee5c0fc 100644
--- a/docs/hibernate.adoc
+++ b/docs/hibernate.adoc
@@ -1,10 +1,10 @@
-# Hibernate
+= Hibernate
:index-group: Unrevised
:jbake-date: 2018-12-05
:jbake-type: page
:jbake-status: published
-# Sample persistence.xml
+= Sample persistence.xml
For a unit called "movie-unit" using two datasources called
"movieDatabase" and "movieDatabaseUnmanaged" the following
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/initialcontext-config.adoc
----------------------------------------------------------------------
diff --git a/docs/initialcontext-config.adoc b/docs/initialcontext-config.adoc
index a487872..60fe0aa 100644
--- a/docs/initialcontext-config.adoc
+++ b/docs/initialcontext-config.adoc
@@ -1,4 +1,4 @@
-# InitialContext Configuration
+= InitialContext Configuration
:index-group: Unrevised
:jbake-date: 2018-12-05
:jbake-type: page
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/installation-drop-in-war.adoc
----------------------------------------------------------------------
diff --git a/docs/installation-drop-in-war.adoc b/docs/installation-drop-in-war.adoc
index 8d2cca2..f578c91 100644
--- a/docs/installation-drop-in-war.adoc
+++ b/docs/installation-drop-in-war.adoc
@@ -1,4 +1,4 @@
-# Installing TomEE using the drop-in .war approach
+= Installing TomEE using the drop-in .war approach
:index-group: Tips and Tricks
:jbake-date: 2018-12-05
:jbake-type: page
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/installation.adoc
----------------------------------------------------------------------
diff --git a/docs/installation.adoc b/docs/installation.adoc
index 6a2cde2..e3670c3 100644
--- a/docs/installation.adoc
+++ b/docs/installation.adoc
@@ -1,10 +1,10 @@
-# Installation
+= Installation
:index-group: Unrevised
:jbake-date: 2018-12-05
:jbake-type: page
:jbake-status: published
-# Installation
+= Installation
Installation is easiest from an update site. In Eclipse, select Help,
Software Updates, Find and install...
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/installing-tomee.adoc
----------------------------------------------------------------------
diff --git a/docs/installing-tomee.adoc b/docs/installing-tomee.adoc
index 27e3050..0e1e5b5 100644
--- a/docs/installing-tomee.adoc
+++ b/docs/installing-tomee.adoc
@@ -1,4 +1,4 @@
-# Installing TomEE
+= Installing TomEE
:index-group: Unrevised
:jbake-date: 2018-12-05
:jbake-type: page
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/java7.adoc
----------------------------------------------------------------------
diff --git a/docs/java7.adoc b/docs/java7.adoc
index 71b15dd..2537117 100644
--- a/docs/java7.adoc
+++ b/docs/java7.adoc
@@ -1,4 +1,4 @@
-# TomEE and Java 7
+= TomEE and Java 7
:index-group: Unrevised
:jbake-date: 2018-12-05
:jbake-type: page
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/javaagent-with-maven-surefire.adoc
----------------------------------------------------------------------
diff --git a/docs/javaagent-with-maven-surefire.adoc b/docs/javaagent-with-maven-surefire.adoc
index 7f48bf1..866a5f9 100644
--- a/docs/javaagent-with-maven-surefire.adoc
+++ b/docs/javaagent-with-maven-surefire.adoc
@@ -1,4 +1,4 @@
-# JavaAgent with Maven Surefire
+= JavaAgent with Maven Surefire
:index-group: Unrevised
:jbake-date: 2018-12-05
:jbake-type: page
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/javaagent.adoc
----------------------------------------------------------------------
diff --git a/docs/javaagent.adoc b/docs/javaagent.adoc
index 1543830..56c1dfd 100644
--- a/docs/javaagent.adoc
+++ b/docs/javaagent.adoc
@@ -1,11 +1,11 @@
-# JavaAgent
+= JavaAgent
:index-group: Unrevised
:jbake-date: 2018-12-05
:jbake-type: page
:jbake-status: published
-# Adding a JavaAgent
+= Adding a JavaAgent
NOTE: The java agent is only required if using OpenJPA as your
persistence provider or if using CMP.
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/javaee7-status.adoc
----------------------------------------------------------------------
diff --git a/docs/javaee7-status.adoc b/docs/javaee7-status.adoc
index 2d2af1f..9f2ab0e 100644
--- a/docs/javaee7-status.adoc
+++ b/docs/javaee7-status.adoc
@@ -1,4 +1,4 @@
-# Java EE 7 Implementation Status
+= Java EE 7 Implementation Status
:index-group: Unrevised
:jbake-date: 2018-12-05
:jbake-type: page
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/javamailsession-config.adoc
----------------------------------------------------------------------
diff --git a/docs/javamailsession-config.adoc b/docs/javamailsession-config.adoc
index 55c8e0c..3764c1b 100644
--- a/docs/javamailsession-config.adoc
+++ b/docs/javamailsession-config.adoc
@@ -1,4 +1,4 @@
-# JavaMailSession Configuration
+= JavaMailSession Configuration
:index-group: Configuration
:jbake-date: 2018-12-05
:jbake-type: page
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/jms-resources-and-mdb-container.adoc
----------------------------------------------------------------------
diff --git a/docs/jms-resources-and-mdb-container.adoc b/docs/jms-resources-and-mdb-container.adoc
index 68fae8d..4a683d4 100644
--- a/docs/jms-resources-and-mdb-container.adoc
+++ b/docs/jms-resources-and-mdb-container.adoc
@@ -1,4 +1,4 @@
-# JMS Resources and MDB Container
+= JMS Resources and MDB Container
:index-group: Configuration
:jbake-date: 2018-12-05
:jbake-type: page
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/jmsconnectionfactory-config.adoc
----------------------------------------------------------------------
diff --git a/docs/jmsconnectionfactory-config.adoc b/docs/jmsconnectionfactory-config.adoc
index 1a821c7..ddaa734 100644
--- a/docs/jmsconnectionfactory-config.adoc
+++ b/docs/jmsconnectionfactory-config.adoc
@@ -1,4 +1,4 @@
-# JmsConnectionFactory Configuration
+= JmsConnectionFactory Configuration
:index-group: Unrevised
:jbake-date: 2018-12-05
:jbake-type: page
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/jndi-names.adoc
----------------------------------------------------------------------
diff --git a/docs/jndi-names.adoc b/docs/jndi-names.adoc
index b98d172..09d54d2 100644
--- a/docs/jndi-names.adoc
+++ b/docs/jndi-names.adoc
@@ -1,11 +1,11 @@
-# JNDI Names
+= JNDI Names
:index-group: Configuration
:jbake-date: 2018-12-05
:jbake-type: page
:jbake-status: published
-# What's My Bean's JNDI Name? There are two things to keep in mind
+= What's My Bean's JNDI Name? There are two things to keep in mind
before you start reading:
1 OpenEJB provides a default JNDI name to your EJB. +
@@ -23,7 +23,7 @@ _interfaceType.annotationName_ are pre-defined variables. There are
other pre-defined variables available which you could use to customize
the JNDI name format.
-# JNDI Name Formatting
+= JNDI Name Formatting
The _openejb.jndiname.format_ property allows you to supply a template
for the global JNDI names of all your EJBs. With it, you have complete
@@ -121,7 +121,7 @@ interfaceClass.packageName
for a class named org.acme.superfun.WidgetRemote results in
org.acme.superfun
-# Setting the JNDI name
+= Setting the JNDI name
It's possible to set the desired jndi name format for the whole server
level, an ejb-jar, an ejb, an ejb's "local" interface
@@ -289,11 +289,11 @@ or
</openejb-jar>
----
-# Changing the Default Setting
+= Changing the Default Setting
_You are responsible for ensuring the names don't conflict._
-=== Conservative settings
+== Conservative settings
A very conservative setting such as
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/jpa-concepts.adoc
----------------------------------------------------------------------
diff --git a/docs/jpa-concepts.adoc b/docs/jpa-concepts.adoc
index 76b7b83..f169c74 100644
--- a/docs/jpa-concepts.adoc
+++ b/docs/jpa-concepts.adoc
@@ -1,10 +1,10 @@
-# JPA Concepts
+= JPA Concepts
:index-group: JPA
:jbake-date: 2018-12-05
:jbake-type: page
:jbake-status: published
-# JPA 101
+= JPA 101
If there's one thing you have to understand to successfully use JPA
(Java Persistence API) it's the concept of a _Cache_. Almost everything
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/jpa-usage.adoc
----------------------------------------------------------------------
diff --git a/docs/jpa-usage.adoc b/docs/jpa-usage.adoc
index 21e0210..ea8dd56 100644
--- a/docs/jpa-usage.adoc
+++ b/docs/jpa-usage.adoc
@@ -1,10 +1,10 @@
-# JPA Usage
+= JPA Usage
:index-group: JPA
:jbake-date: 2018-12-05
:jbake-type: page
:jbake-status: published
-# Things to watch out for
+= Things to watch out for
== Critical: Always set jta-data-source and non-jta-data-source
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/local-client-injection.adoc
----------------------------------------------------------------------
diff --git a/docs/local-client-injection.adoc b/docs/local-client-injection.adoc
index d544a31..51220bd 100644
--- a/docs/local-client-injection.adoc
+++ b/docs/local-client-injection.adoc
@@ -1,4 +1,4 @@
-# Local Client Injection
+= Local Client Injection
:index-group: Testing Techniques
:jbake-date: 2018-12-05
:jbake-type: page
@@ -31,7 +31,7 @@ that needs to pull objects from the Embedded EJB container. Classes with
module may have as many classes annotated with @LocalClient as it
wishes.
-# Injection
+= Injection
The injection occurs via acquiring a LocalInitialContext via the
LocalInitialContextFactory and calling _bind("inject", instance)_
@@ -62,7 +62,7 @@ public class MoviesTest extends TestCase {
}
----
-# Discovery
+= Discovery
All EJB modules are scanned for @LocalClient classes, even if those EJB
Modules are inside .war files as with the
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/local-server.adoc
----------------------------------------------------------------------
diff --git a/docs/local-server.adoc b/docs/local-server.adoc
index a96d1b8..e039b97 100644
--- a/docs/local-server.adoc
+++ b/docs/local-server.adoc
@@ -1,4 +1,4 @@
-# Local Server
+= Local Server
:index-group: Unrevised
:jbake-date: 2018-12-05
:jbake-type: page
@@ -12,7 +12,7 @@ what we call the Local Server and avoid the network overhead and enjoy
an easy way to embedd OpenEJB. Instead of putting the app in the server,
put the server in the app!
-# Say what?! A local server?
+= Say what?! A local server?
Yes, you read correctly. OpenEJB can be embedded and treated as your
very own personal EJB container.
@@ -50,7 +50,7 @@ things. All it does is dish out proxies to your app that can be used to
shoot calls right into the EJB Container. Very light, very fast, very
easy for testing, debugging, developing, etc.
-# Embedding
+= Embedding
!http://www.openejb.org/images/diagram-local-server.gif|valign=top,
align=right, hspace=15! \{include:OPENEJBx30:Embedding}
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/lookup-of-other-ejbs-example.adoc
----------------------------------------------------------------------
diff --git a/docs/lookup-of-other-ejbs-example.adoc b/docs/lookup-of-other-ejbs-example.adoc
index 1b85b2d..ada2b8a 100644
--- a/docs/lookup-of-other-ejbs-example.adoc
+++ b/docs/lookup-of-other-ejbs-example.adoc
@@ -1,10 +1,10 @@
-# Lookup of other EJBs Example
+= Lookup of other EJBs Example
:index-group: Unrevised
:jbake-date: 2018-12-05
:jbake-type: page
:jbake-status: published
-# Overview
+= Overview
This example shows how to configure JNDI to lookup other EJBs using
either the _@EJB_ annotation or the _ejb-jar.xml_ deployment descriptor.
@@ -63,7 +63,7 @@ _java:comp/env/myFriend_ differently which is allowed as _java:comp_ is
a namespace that is private to each bean and not visible to other beans
-- so the names do not have to match.
-# The Code
+= The Code
Here we show the code for _RedBean_ and _BlueBean_ and their shared
business local interface _Friend_.
@@ -85,7 +85,7 @@ If there is a desire to not use annotations, the above annotation usage
is equivalent to the following ejb-jar.xml
\{snippet:url=openejb3/examples/lookup-of-ejbs-with-descriptor/src/main/resources/META-INF/ejb-jar.xml|lang=xml}
-# Writing a unit test for the example
+= Writing a unit test for the example
Writing an unit test for this example is quite simple. We need just to
write a setup method to create and initialize the InitialContext, and
@@ -93,7 +93,7 @@ then write our test methods
\{snippet:id=code|url=openejb3/examples/lookup-of-ejbs/src/test/java/org/superbiz/ejblookup/EjbDependencyTest.java|lang=java}
-# Running
+= Running
Running the example is fairly simple. In the "lookup-of-ejbs" directory
of the openejb:download.html[examples zip] , just run:
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/managedcontainer-config.adoc
----------------------------------------------------------------------
diff --git a/docs/managedcontainer-config.adoc b/docs/managedcontainer-config.adoc
index e58e4fd..869200f 100644
--- a/docs/managedcontainer-config.adoc
+++ b/docs/managedcontainer-config.adoc
@@ -1,4 +1,4 @@
-# ManagedContainer Configuration
+= ManagedContainer Configuration
:index-group: Unrevised
:jbake-date: 2018-12-05
:jbake-type: page
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/manual-installation.adoc
----------------------------------------------------------------------
diff --git a/docs/manual-installation.adoc b/docs/manual-installation.adoc
index f36233c..fc4aceb 100644
--- a/docs/manual-installation.adoc
+++ b/docs/manual-installation.adoc
@@ -1,4 +1,4 @@
-# Manual Installation
+= Manual Installation
:index-group: Unrevised
:jbake-date: 2018-12-05
:jbake-type: page
@@ -23,7 +23,7 @@ http://tomee.apache.org/downloads.html[download page]
. Add the OpenEJB JavaAgent to the bin/catalina.bat or bin/catalina.bat
script
-##Install openejb.war
+== Install openejb.war
Once Tomcat has been link:tomcat-installation.html[installed] , the
OpenEJB plugin for Tomcat can be installed. The war can be obtained from
@@ -143,6 +143,6 @@ fi
#End of Snippet to add
----
-##Note: The example above is an excerpt from the middle of the
+== Note: The example above is an excerpt from the middle of the
bin/catalina.sh file. Search for the this section and add the snippet
shown
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/maven.adoc
----------------------------------------------------------------------
diff --git a/docs/maven.adoc b/docs/maven.adoc
index 36cd293..c536986 100644
--- a/docs/maven.adoc
+++ b/docs/maven.adoc
@@ -4,7 +4,7 @@
:jbake-status: published
-# Maven
+= Maven
Information
This page is intended to provide an insight into basic
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/maven/index.adoc
----------------------------------------------------------------------
diff --git a/docs/maven/index.adoc b/docs/maven/index.adoc
index fafcbfa..43ee09b 100644
--- a/docs/maven/index.adoc
+++ b/docs/maven/index.adoc
@@ -1,4 +1,4 @@
-# TomEE Maven Plugin
+= TomEE Maven Plugin
:index-group: TomEE Maven Plugin
:jbake-date: 2018-12-05
:jbake-type: page
@@ -30,7 +30,7 @@ Simply add the following to the , and optionally the ), section of your
</plugins>
----
-###Plugin Goals
+== Plugin Goals
Goal
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/messagedrivencontainer-config.adoc
----------------------------------------------------------------------
diff --git a/docs/messagedrivencontainer-config.adoc b/docs/messagedrivencontainer-config.adoc
index 87adc93..640390f 100644
--- a/docs/messagedrivencontainer-config.adoc
+++ b/docs/messagedrivencontainer-config.adoc
@@ -1,4 +1,4 @@
-# MessageDrivenContainer Configuration
+= MessageDrivenContainer Configuration
:index-group: Unrevised
:jbake-date: 2018-12-05
:jbake-type: page
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/multicast-discovery.adoc
----------------------------------------------------------------------
diff --git a/docs/multicast-discovery.adoc b/docs/multicast-discovery.adoc
index 0744c6d..926f916 100644
--- a/docs/multicast-discovery.adoc
+++ b/docs/multicast-discovery.adoc
@@ -1,4 +1,4 @@
-# Multicast (UDP) Discovery
+= Multicast (UDP) Discovery
:index-group: Discovery and Failover
:jbake-date: 2018-12-05
:jbake-type: page
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/multiple-business-interface-hazzards.adoc
----------------------------------------------------------------------
diff --git a/docs/multiple-business-interface-hazzards.adoc b/docs/multiple-business-interface-hazzards.adoc
index 45b736e..47828b5 100644
--- a/docs/multiple-business-interface-hazzards.adoc
+++ b/docs/multiple-business-interface-hazzards.adoc
@@ -1,10 +1,10 @@
-# Multiple Business Interface Hazzards
+= Multiple Business Interface Hazzards
:index-group: Unrevised
:jbake-date: 2018-12-05
:jbake-type: page
:jbake-status: published
-# UndeclaredThrowableException
+= UndeclaredThrowableException
When two java interfaces are implemented by a proxy and those two
interfaces declare the _same method_ but with _different throws clauses_
@@ -112,7 +112,7 @@ executes } catch(Throwable t)\{ fail("Caught: "+t); }
\{ public Object invoke(Object proxy, Method method, Object[] args)
throws Throwable \{ throw (Throwable)args[0] ; } } }
-# IllegalArgumentException
+= IllegalArgumentException
This one is less of a runtime problem as doing this will cause things to
fail up front. When two java interfaces are implemented by a proxy and
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/multipoint-considerations.adoc
----------------------------------------------------------------------
diff --git a/docs/multipoint-considerations.adoc b/docs/multipoint-considerations.adoc
index e232020..34746e4 100644
--- a/docs/multipoint-considerations.adoc
+++ b/docs/multipoint-considerations.adoc
@@ -1,4 +1,4 @@
-# Multipoint Considerations
+= Multipoint Considerations
:index-group: Discovery and Failover
:jbake-date: 2018-12-05
:jbake-type: page
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/multipoint-discovery.adoc
----------------------------------------------------------------------
diff --git a/docs/multipoint-discovery.adoc b/docs/multipoint-discovery.adoc
index 77379fc..bfc20af 100644
--- a/docs/multipoint-discovery.adoc
+++ b/docs/multipoint-discovery.adoc
@@ -1,4 +1,4 @@
-# Multipoint (TCP) Discovery
+= Multipoint (TCP) Discovery
:index-group: Discovery and Failover
:jbake-date: 2018-12-05
:jbake-type: page
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/multipoint-recommendations.adoc
----------------------------------------------------------------------
diff --git a/docs/multipoint-recommendations.adoc b/docs/multipoint-recommendations.adoc
index 45048ee..d31105b 100644
--- a/docs/multipoint-recommendations.adoc
+++ b/docs/multipoint-recommendations.adoc
@@ -1,4 +1,4 @@
-# Multipoint Recommendations
+= Multipoint Recommendations
:index-group: Discovery and Failover
:jbake-date: 2018-12-05
:jbake-type: page
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/multipulse-discovery.adoc
----------------------------------------------------------------------
diff --git a/docs/multipulse-discovery.adoc b/docs/multipulse-discovery.adoc
index bee02c5..a7d9824 100644
--- a/docs/multipulse-discovery.adoc
+++ b/docs/multipulse-discovery.adoc
@@ -1,4 +1,4 @@
-# MultiPulse (UDP) Discovery
+= MultiPulse (UDP) Discovery
:index-group: Discovery and Failover
:jbake-date: 2018-12-05
:jbake-type: page
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/new-in-openejb-3.0.adoc
----------------------------------------------------------------------
diff --git a/docs/new-in-openejb-3.0.adoc b/docs/new-in-openejb-3.0.adoc
index d1e7fef..c3d6589 100644
--- a/docs/new-in-openejb-3.0.adoc
+++ b/docs/new-in-openejb-3.0.adoc
@@ -1,9 +1,9 @@
-# New in OpenEJB 3.0
+= New in OpenEJB 3.0
:jbake-date: 2018-12-05
:jbake-type: page
:jbake-status: published
-## EJB 3.0
+== EJB 3.0
OpenEJB 3.0 supports the EJB 3.0 specification as well as the prior EJB
2.1, EJB 2.0, and EJB 1.1. New features in EJB 3.0 include:
@@ -26,7 +26,7 @@ Services (JAX-WS, JAX-RPC) - CORBA
JAX-WS and CORBA support will be added in future releases. Support for
the JAX-RPC API is not a planned feature.
-# Extensions to EJB 3.0
+= Extensions to EJB 3.0
== CMP via JPA
@@ -136,7 +136,7 @@ for beginners and people using OpenEJB in a classroom setting.
== Most configurable JNDI names ever
-# General Improvements
+= General Improvements
== Online Deployment ## Security Service ## Connection Pooling ##
Configuration Overriding ## Flexible JNDI Name Formatting ## Cleaner
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/openejb-3.adoc
----------------------------------------------------------------------
diff --git a/docs/openejb-3.adoc b/docs/openejb-3.adoc
index 260bbb4..aeffb11 100644
--- a/docs/openejb-3.adoc
+++ b/docs/openejb-3.adoc
@@ -1,11 +1,11 @@
-# OpenEJB 3
+= OpenEJB 3
:index-group: Unrevised
:jbake-date: 2018-12-05
:jbake-type: page
:jbake-status: published
-# Past, Present, and Future
+= Past, Present, and Future
The goal of OpenEJB 3 is to merge our past, present, and future into one
codebase. OpenEJB 3 will take the excellent features in OpenEJB 1.0
@@ -13,7 +13,7 @@ codebase. OpenEJB 3 will take the excellent features in OpenEJB 1.0
towards an IoC architecture based on Gbean.org and Spring, bring in the
OpenEJB 2 code, and implement the EJB 3.0 specification.
-# The Plan
+= The Plan
We will start on OpenEJB 3 by taking the 1.0 code (pretty much the same
as 0.9.2), merging in the 2.0 code, and ensuring that the entire time
@@ -53,7 +53,7 @@ go such as deployment descriptors with attributes, simpler packaging,
more flexible classloader setup, more powerful IoC support, simpler web
services support and more.
-# Release on Day One
+= Release on Day One
Keep it working, keep it progressing, keep releasing. The 3.0 version
number won't be the finishing line, but the starting line. Our work will
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/openejb-binaries.adoc
----------------------------------------------------------------------
diff --git a/docs/openejb-binaries.adoc b/docs/openejb-binaries.adoc
index 2a3d6f4..c31e99e 100644
--- a/docs/openejb-binaries.adoc
+++ b/docs/openejb-binaries.adoc
@@ -1,4 +1,4 @@
-# OpenEJB Binaries
+= OpenEJB Binaries
:index-group: Unrevised
:jbake-date: 2018-12-05
:jbake-type: page
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/openejb-eclipse-plugin.adoc
----------------------------------------------------------------------
diff --git a/docs/openejb-eclipse-plugin.adoc b/docs/openejb-eclipse-plugin.adoc
index 670e936..6f912e7 100644
--- a/docs/openejb-eclipse-plugin.adoc
+++ b/docs/openejb-eclipse-plugin.adoc
@@ -1,12 +1,12 @@
-# OpenEJB Eclipse Plugin
+= OpenEJB Eclipse Plugin
:index-group: Unrevised
:jbake-date: 2018-12-05
:jbake-type: page
:jbake-status: published
-# OpenEJB Eclipse Plugin
+= OpenEJB Eclipse Plugin
-=== Overview
+== Overview
The OpenEJB plugin for Eclipse provides the ability to run an OpenEJB
standalone server and deploy projects directly from within the IDE,
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/openejb-jsr-107-integration.adoc
----------------------------------------------------------------------
diff --git a/docs/openejb-jsr-107-integration.adoc b/docs/openejb-jsr-107-integration.adoc
index e7b3172..523fb4a 100644
--- a/docs/openejb-jsr-107-integration.adoc
+++ b/docs/openejb-jsr-107-integration.adoc
@@ -1,22 +1,22 @@
-# OpenEJB JSR-107 Integration
+= OpenEJB JSR-107 Integration
:index-group: Unrevised
:jbake-date: 2018-12-05
:jbake-type: page
:jbake-status: published
-# OpenEJB JSR-107 (JCACHE) Integration
+= OpenEJB JSR-107 (JCACHE) Integration
This page is for the collaboration for those involved with the
integration of JSR-107 into OpenEJB.
-=== Overview
+== Overview
The idea here is to add a caching layer to OpenEJB. The overall
objective is to improve performance in OpenEJB where applicable through
caching EJBs.
-=== Status
+== Status
Dain and myself (Jeremy) have deciphered the JSR-107 spec and how I am
working on the first crude integration of JCACHE into OpenEJB. Anyone
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/openejb.xml.adoc
----------------------------------------------------------------------
diff --git a/docs/openejb.xml.adoc b/docs/openejb.xml.adoc
index 9d085a3..051c392 100644
--- a/docs/openejb.xml.adoc
+++ b/docs/openejb.xml.adoc
@@ -1,10 +1,10 @@
-# openejb.xml
+= openejb.xml
:jbake-date: 2018-12-05
:jbake-type: page
:jbake-status: published
-## Overview
+== Overview
The openejb.xml is the main configuration file for the container system
and its services such as transaction, security, and data sources.
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/openjpa.adoc
----------------------------------------------------------------------
diff --git a/docs/openjpa.adoc b/docs/openjpa.adoc
index 1f1fea1..a9078ac 100644
--- a/docs/openjpa.adoc
+++ b/docs/openjpa.adoc
@@ -1,4 +1,4 @@
-# OpenJPA
+= OpenJPA
:index-group: JPA
:jbake-date: 2018-12-05
:jbake-type: page
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/orb-config.adoc
----------------------------------------------------------------------
diff --git a/docs/orb-config.adoc b/docs/orb-config.adoc
index 559d969..f06f86e 100644
--- a/docs/orb-config.adoc
+++ b/docs/orb-config.adoc
@@ -1,4 +1,4 @@
-# ORB Configuration
+= ORB Configuration
:index-group: Configuration
:jbake-date: 2018-12-05
:jbake-type: page
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/persistence-context.adoc
----------------------------------------------------------------------
diff --git a/docs/persistence-context.adoc b/docs/persistence-context.adoc
index dc36fd0..91e456e 100644
--- a/docs/persistence-context.adoc
+++ b/docs/persistence-context.adoc
@@ -1,10 +1,10 @@
-# persistence-context
+= persistence-context
:index-group: JPA
:jbake-date: 2018-12-05
:jbake-type: page
:jbake-status: published
-# Via annotation
+= Via annotation
Both lookup and injection of an EntityManager can be configured via the
`@PersistenceContext` annotation.
@@ -36,7 +36,7 @@ public class MyBean implements MyInterface {
}
----
-# Via xml
+= Via xml
The above @PersistenceContext annotation usage is 100% equivalent to the
following xml.
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/persistence-unit-ref.adoc
----------------------------------------------------------------------
diff --git a/docs/persistence-unit-ref.adoc b/docs/persistence-unit-ref.adoc
index bb88158..6da6447 100644
--- a/docs/persistence-unit-ref.adoc
+++ b/docs/persistence-unit-ref.adoc
@@ -1,4 +1,4 @@
-# persistence-unit-ref
+= persistence-unit-ref
:index-group: JPA
:jbake-date: 2018-12-05
:jbake-type: page
@@ -9,7 +9,7 @@ EntityManagerFactory can be configured via the @PersistenceUnit
annotation or in xml. Annotations and xml have equal function in both
lookup and injection.
-# Injection and Lookup
+= Injection and Lookup
== Via annotation
@@ -80,7 +80,7 @@ public class MyBean implements MyInterface {
}
----
-# Via xml
+= Via xml
The above @PersistenceUnit annotation usage is 100% equivalent to the
following xml.
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/properties-listing.adoc
----------------------------------------------------------------------
diff --git a/docs/properties-listing.adoc b/docs/properties-listing.adoc
index 27738b3..6ae202b 100644
--- a/docs/properties-listing.adoc
+++ b/docs/properties-listing.adoc
@@ -1,4 +1,4 @@
-# System Properties Listing
+= System Properties Listing
:index-group: Unrevised
:jbake-date: 2018-12-05
:jbake-type: page
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/properties-tool.adoc
----------------------------------------------------------------------
diff --git a/docs/properties-tool.adoc b/docs/properties-tool.adoc
index 2178877..ad0843f 100644
--- a/docs/properties-tool.adoc
+++ b/docs/properties-tool.adoc
@@ -1,10 +1,10 @@
-# Properties Tool
+= Properties Tool
:index-group: OpenEJB Standalone Server
:jbake-date: 2018-12-05
:jbake-type: page
:jbake-status: published
-# Properties Command line Tool
+= Properties Command line Tool
To see all configurable properties in use by OpenEJB, using the
following tool against a running server:
@@ -28,7 +28,7 @@ component declarations. The only warning is that any properties of type
".password" will have their values masked, so make sure you edit them if
you reapply them back into conf/openejb.xml or conf/system.properties.
-# Property Overriding
+= Property Overriding
Any component configured in OpenEJB via the openejb.xml (and some that
aren't) can be overridden using system properties. The format is:
@@ -52,7 +52,7 @@ is created).
At startup, OpenEJB will find the component with the given id and apply
the new property value before constructing the individual component.
-# Example output
+= Example output
[source,properties]
----
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/property-overriding.adoc
----------------------------------------------------------------------
diff --git a/docs/property-overriding.adoc b/docs/property-overriding.adoc
index 00cda34..c2747ab 100644
--- a/docs/property-overriding.adoc
+++ b/docs/property-overriding.adoc
@@ -1,4 +1,4 @@
-# Property Overriding
+= Property Overriding
:index-group: Unrevised
:jbake-date: 2018-12-05
:jbake-type: page
@@ -15,7 +15,7 @@ overwritten before the component is created.
We call this overriding and there are several ways to do it.
-# The openejb.xml
+= The openejb.xml
The default openejb.xml file has most of the useful properties for each
component explicitly listed with default values for documentation
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/provisioning.adoc
----------------------------------------------------------------------
diff --git a/docs/provisioning.adoc b/docs/provisioning.adoc
index df9bf35..e3ecb51 100644
--- a/docs/provisioning.adoc
+++ b/docs/provisioning.adoc
@@ -1,4 +1,4 @@
-# TomEE/OpenEJB provisioning
+= TomEE/OpenEJB provisioning
:index-group: Unrevised
:jbake-date: 2018-12-05
:jbake-type: page
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/proxyfactory-config.adoc
----------------------------------------------------------------------
diff --git a/docs/proxyfactory-config.adoc b/docs/proxyfactory-config.adoc
index 27e234a..2a91741 100644
--- a/docs/proxyfactory-config.adoc
+++ b/docs/proxyfactory-config.adoc
@@ -1,4 +1,4 @@
-# ProxyFactory Configuration
+= ProxyFactory Configuration
:index-group: Unrevised
:jbake-date: 2018-12-05
:jbake-type: page
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/queue-config.adoc
----------------------------------------------------------------------
diff --git a/docs/queue-config.adoc b/docs/queue-config.adoc
index 1e9343c..8c02cc5 100644
--- a/docs/queue-config.adoc
+++ b/docs/queue-config.adoc
@@ -1,4 +1,4 @@
-# Queue Configuration
+= Queue Configuration
:index-group: Unrevised
:jbake-date: 2018-12-05
:jbake-type: page
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/quickstart.adoc
----------------------------------------------------------------------
diff --git a/docs/quickstart.adoc b/docs/quickstart.adoc
index f8ce3f6..f75f59e 100644
--- a/docs/quickstart.adoc
+++ b/docs/quickstart.adoc
@@ -1,10 +1,10 @@
-# Quickstart
+= Quickstart
:index-group: Unrevised
:jbake-date: 2018-12-05
:jbake-type: page
:jbake-status: published
-# Installation
+= Installation
To install OpenEJB, simply link:downloads.html[download the latest
binary] and unpack your zip or tar.gz into the directory where you want
@@ -25,7 +25,7 @@ this directory is your OPENEJB_HOME directory. The OPENEJB_HOME
directory is referred to in various parts of the documentation, so it's
good to remember where it is.
-# Using OpenEJB
+= Using OpenEJB
Now all you need to do is move to the bin directory in OPENEJB_HOME, the
directory where OpenEJB was unpacked, and type:
@@ -61,7 +61,7 @@ That's it!
If you don't have any EJBs or clients to run, try the ubiquitous
openejbx30:hello-world.html[Hello World] example.
-# Join the mailing list
+= Join the mailing list
The OpenEJB User list is where the general OpenEJB community goes to ask
questions, make suggestions, chat with other users, and keep a finger on
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/remote-server.adoc
----------------------------------------------------------------------
diff --git a/docs/remote-server.adoc b/docs/remote-server.adoc
index f20f724..24411ac 100644
--- a/docs/remote-server.adoc
+++ b/docs/remote-server.adoc
@@ -1,4 +1,4 @@
-# Remote Server
+= Remote Server
:index-group: Unrevised
:jbake-date: 2018-12-05
:jbake-type: page
@@ -14,7 +14,7 @@ accessing an EJB's Remote Interface is the same, however to actually
connect across a network to the server, you need to specify different
JNDI parameters.
-# Short version
+= Short version
Using OpenEJB's default remote server implementation is pretty straight
forward. You simply need to:
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/resource-injection.adoc
----------------------------------------------------------------------
diff --git a/docs/resource-injection.adoc b/docs/resource-injection.adoc
index 3f6665c..4e709b0 100644
--- a/docs/resource-injection.adoc
+++ b/docs/resource-injection.adoc
@@ -4,7 +4,7 @@
:jbake-status: published
-# @Resource
+= @Resource
Overview
This example demonstrates the use of the injection of environment
@@ -49,7 +49,7 @@ ___________________
$ mvn clean install
___________________
-# The Code
+= The Code
== Injection through field (field-level injection)
@@ -60,7 +60,7 @@ The default value of 10 is assigned. You can modify the value of the
environment entries at deployment time using deployment descriptor
(*ejb-jar.xml*).
-==== @Resource annotation of a field
+=== @Resource annotation of a field
[source,java]
----
@@ -86,7 +86,7 @@ The pattern is to combine the fully-qualified class name and the name of
a instance field (or a name of the setter method without _set_ prefix
and the first letter lowercased).
-==== @Resource annotation of a setter method
+=== @Resource annotation of a setter method
[source,java]
----
@@ -96,7 +96,7 @@ public void setMaxLineItems(int maxLineItems) {
}
----
-==== Using env-entry in ejb-jar.xml
+=== Using env-entry in ejb-jar.xml
[source,xml]
----
@@ -108,7 +108,7 @@ public void setMaxLineItems(int maxLineItems) {
</env-entry>
----
-==== Using @Resource annotated env-entry
+=== Using @Resource annotated env-entry
[source,java]
----
@@ -126,13 +126,13 @@ public void addLineItem(LineItem item) throws TooManyItemsException {
}
----
-# JUnit Test
+= JUnit Test
Writing an JUnit test for this example is quite simple. We need just to
write a setup method to create and initialize the InitialContext, and
then write our test methods.
-==== Test fixture
+== Test fixture
[source,java]
----
@@ -144,7 +144,7 @@ protected void setUp() throws Exception {
}
----
-==== Test methods
+== Test methods
[source,java]
----
@@ -161,7 +161,7 @@ public void testAddLineItem() throws Exception {
}
----
-# Running
+= Running
Running the example is fairly simple. Just execute the following
commands:
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/resource-ref-for-datasource.adoc
----------------------------------------------------------------------
diff --git a/docs/resource-ref-for-datasource.adoc b/docs/resource-ref-for-datasource.adoc
index 8d919dc..4112c62 100644
--- a/docs/resource-ref-for-datasource.adoc
+++ b/docs/resource-ref-for-datasource.adoc
@@ -4,7 +4,7 @@
:jbake-status: published
-# Via annotation
+= Via annotation
[source,java]
----
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/running-a-standalone-openejb-server.adoc
----------------------------------------------------------------------
diff --git a/docs/running-a-standalone-openejb-server.adoc b/docs/running-a-standalone-openejb-server.adoc
index acd1583..bebb083 100644
--- a/docs/running-a-standalone-openejb-server.adoc
+++ b/docs/running-a-standalone-openejb-server.adoc
@@ -1,11 +1,11 @@
-# Running a standalone OpenEJB server
+= Running a standalone OpenEJB server
:index-group: Unrevised
:jbake-date: 2018-12-05
:jbake-type: page
:jbake-status: published
-# Configuring the OpenEJB Runtime The OpenEJB Eclipse plugin provides
+= Configuring the OpenEJB Runtime The OpenEJB Eclipse plugin provides
support for running OpenEJB as a standalone server in Eclipse using WTP.
To setup a server, first of all, you will need to have a copy of OpenEJB
@@ -25,7 +25,7 @@ image:http://people.apache.org/~jgallimore/images/server_step_5.jpg[http://peopl
Browse to, or enter the path to your copy of OpenEJB. Click on Finish.
-# Configuring the OpenEJB Server Open the Servers view (if it isn't
+= Configuring the OpenEJB Server Open the Servers view (if it isn't
already), and right click and select New->Server.
image:http://people.apache.org/~jgallimore/images/server_step_8.jpg[http://people.apache.org/~jgallimore/images/server_step_8.jpg]
@@ -39,7 +39,7 @@ Select the EJB port for the server, and select Finish.
image:http://people.apache.org/~jgallimore/images/server_step_10.jpg[http://people.apache.org/~jgallimore/images/server_step_10.jpg]
-# Deploying a project In order to deploy your project to an OpenEJB
+= Deploying a project In order to deploy your project to an OpenEJB
server in Eclipse, your project must be a Java EE project, with the EJB
facet enabled. If your project doesn't have the Faceted nature, you can
use the OpenEJB plugin to add it. Simply select OpenEJB->Add Faceted
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/securing-a-web-service.adoc
----------------------------------------------------------------------
diff --git a/docs/securing-a-web-service.adoc b/docs/securing-a-web-service.adoc
index ad38568..3055ae0 100644
--- a/docs/securing-a-web-service.adoc
+++ b/docs/securing-a-web-service.adoc
@@ -1,4 +1,4 @@
-# Securing a Web Service
+= Securing a Web Service
:index-group: Unrevised
:jbake-date: 2018-12-05
:jbake-type: page
@@ -79,7 +79,7 @@ you can configure either one or the other or both. You can decide to
check client credentials for incoming messages and sign outgoing
messages (response).
-# Configuration principles The configuration is made in the
+= Configuration principles The configuration is made in the
_openejb-jar.xml_. Each endpoint web service can provide a set of
properties to customize WS-Security behavior through the element. The
content of this element is consistent with the overall structure of
@@ -100,7 +100,7 @@ naming conventions. Each property is made of .<in|out>.=
For example : _wss4j.in.action = UsernameToken_
-# Username Token (Password digest) example #### Excerpt from
+= Username Token (Password digest) example #### Excerpt from
_openejb-jar.xml_.
[source,xml]
@@ -126,7 +126,7 @@ _openejb-jar.xml_.
</openejb-jar>
----
-==== Request sent by the client. This request contains SOAP headers to
+== Request sent by the client. This request contains SOAP headers to
manage security. You can see _UsernameToken_ tag from the WS-Security
specification.
@@ -167,7 +167,7 @@ xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-s
</soap:Envelope>
----
-==== The response returned from the server.
+== The response returned from the server.
[source,properties]
----
@@ -186,7 +186,7 @@ Server: OpenEJB/??? (unknown os)
</soap:Envelope>
----
-# JAAS with WS-Security
+= JAAS with WS-Security
1 doesn't work straight off with WS-Security, but you can add calls to
the OpenEJB SecurityService to login to a JAAS provider to a
@@ -236,5 +236,5 @@ public class CustomPasswordHandler implements CallbackHandler {
}
----
-# Examples A full example (webservice-ws-security) is available with
+= Examples A full example (webservice-ws-security) is available with
OpenEJB Examples.
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/security-annotations.adoc
----------------------------------------------------------------------
diff --git a/docs/security-annotations.adoc b/docs/security-annotations.adoc
index 2f86153..ca44e5c 100644
--- a/docs/security-annotations.adoc
+++ b/docs/security-annotations.adoc
@@ -1,4 +1,4 @@
-# Security Annotations
+= Security Annotations
:index-group: Unrevised
:jbake-date: 2018-12-05
:jbake-type: page
@@ -252,7 +252,7 @@ public class OpenSourceProjectBean implements Project {
* Allow anyone logged in or not to invoke 'svnCheckout'.
* Allow _no one_ logged in or not to invoke 'deleteProject'.
-# Illegal Usage
+= Illegal Usage
Generally, security restrictions cannot be made on AroundInvoke methods
and most callbacks.
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/security.adoc
----------------------------------------------------------------------
diff --git a/docs/security.adoc b/docs/security.adoc
index 3f763b7..172d284 100644
--- a/docs/security.adoc
+++ b/docs/security.adoc
@@ -1,10 +1,10 @@
-# Security
+= Security
:index-group: Configuration
:jbake-date: 2018-12-05
:jbake-type: page
:jbake-status: published
-# Security - How To.
+= Security - How To.
We currently have two authentication mechanisms to choose from: *
_PropertiesLoginModule_ (a basic text file based login that looks up
@@ -155,7 +155,7 @@ the digest encoding, can be "hex" or "base64"
no
-# PLUG POINTS
+= PLUG POINTS
There are four-five different plug points where you could customize the
functionality. From largest to smallest: - _The SecurityService
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/securityservice-config.adoc
----------------------------------------------------------------------
diff --git a/docs/securityservice-config.adoc b/docs/securityservice-config.adoc
index 8efb906..7cb05fe 100644
--- a/docs/securityservice-config.adoc
+++ b/docs/securityservice-config.adoc
@@ -1,4 +1,4 @@
-# SecurityService Configuration
+= SecurityService Configuration
:index-group: Unrevised
:jbake-date: 2018-12-05
:jbake-type: page
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/service-locator.adoc
----------------------------------------------------------------------
diff --git a/docs/service-locator.adoc b/docs/service-locator.adoc
index 7fba3f7..5a7e1e3 100644
--- a/docs/service-locator.adoc
+++ b/docs/service-locator.adoc
@@ -1,4 +1,4 @@
-# Service Locator
+= Service Locator
:index-group: Unrevised
:jbake-date: 2018-12-05
:jbake-type: page
@@ -10,7 +10,7 @@ really fun service locator code. Creating the exact layout you want
using the exact data you want means you can create robust libraries for
pulling things out of JNDI.
-# Lookup examples
+= Lookup examples
To get the creative juices flowing here are a few examples of lookup
methods you could create for your service locator, the jndi name formats
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/services.adoc
----------------------------------------------------------------------
diff --git a/docs/services.adoc b/docs/services.adoc
index 140aeba..ccdac8c 100644
--- a/docs/services.adoc
+++ b/docs/services.adoc
@@ -1,4 +1,4 @@
-# ServicePool and Services
+= ServicePool and Services
:index-group: Unrevised
:jbake-date: 2018-12-05
:jbake-type: page
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/singleton-beans.adoc
----------------------------------------------------------------------
diff --git a/docs/singleton-beans.adoc b/docs/singleton-beans.adoc
index 1c0ef75..cdde70e 100644
--- a/docs/singleton-beans.adoc
+++ b/docs/singleton-beans.adoc
@@ -1,10 +1,10 @@
-# Singleton Beans
+= Singleton Beans
:index-group: Unrevised
:jbake-date: 2018-12-05
:jbake-type: page
:jbake-status: published
-# Singleton Overview For the first time in years EJB has a new
+= Singleton Overview For the first time in years EJB has a new
bean type, the _@Singleton_. In my opinion, the javax.ejb.Singleton will
replace a lot of what people are using @Stateless for today.
@@ -209,7 +209,7 @@ of creating circular dependencies, it is better not to use the
@DependsOn annotation "just in case" and should only be used when truly
needed.
-# XML and Annotation Overriding
+= XML and Annotation Overriding
Singletons can be declared in the ejb-jar.xml as follows:
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/singleton-ejb.adoc
----------------------------------------------------------------------
diff --git a/docs/singleton-ejb.adoc b/docs/singleton-ejb.adoc
index 689e308..b76c590 100644
--- a/docs/singleton-ejb.adoc
+++ b/docs/singleton-ejb.adoc
@@ -1,4 +1,4 @@
-# Singleton EJB
+= Singleton EJB
:index-group: Unrevised
:jbake-date: 2018-12-05
:jbake-type: page
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/singletoncontainer-config.adoc
----------------------------------------------------------------------
diff --git a/docs/singletoncontainer-config.adoc b/docs/singletoncontainer-config.adoc
index a75e92c..489dae9 100644
--- a/docs/singletoncontainer-config.adoc
+++ b/docs/singletoncontainer-config.adoc
@@ -1,4 +1,4 @@
-# SingletonContainer Configuration
+= SingletonContainer Configuration
:index-group: Unrevised
:jbake-date: 2018-12-05
:jbake-type: page
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/spring-and-openejb-3.0.adoc
----------------------------------------------------------------------
diff --git a/docs/spring-and-openejb-3.0.adoc b/docs/spring-and-openejb-3.0.adoc
index 86924bc..cac311c 100644
--- a/docs/spring-and-openejb-3.0.adoc
+++ b/docs/spring-and-openejb-3.0.adoc
@@ -1,4 +1,4 @@
-# Spring and OpenEJB 3.0
+= Spring and OpenEJB 3.0
:jbake-date: 2018-12-05
:jbake-type: page
:jbake-status: published
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/spring-ejb-and-jpa.adoc
----------------------------------------------------------------------
diff --git a/docs/spring-ejb-and-jpa.adoc b/docs/spring-ejb-and-jpa.adoc
index 0c67882..e97f434 100644
--- a/docs/spring-ejb-and-jpa.adoc
+++ b/docs/spring-ejb-and-jpa.adoc
@@ -1,4 +1,4 @@
-# Spring EJB and JPA
+= Spring EJB and JPA
:index-group: Spring
:jbake-date: 2018-12-05
:jbake-type: page
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/spring.adoc
----------------------------------------------------------------------
diff --git a/docs/spring.adoc b/docs/spring.adoc
index 7f2e5b3..1951551 100644
--- a/docs/spring.adoc
+++ b/docs/spring.adoc
@@ -1,4 +1,4 @@
-# Spring
+= Spring
:index-group: Spring
:jbake-date: 2018-12-05
:jbake-type: page
@@ -8,7 +8,7 @@
and will change based on user feedback. All comments suggestions
welcome. \{note}
-# Introduction
+= Introduction
The OpenEJB Spring integration makes all Spring defined beans injectable
to Java EE components, and all Java EE components can be injected to
@@ -32,7 +32,7 @@ including:
_Requirements:_ * OpenEJB 3.1+ * Spring X.X * Java 1.5 or 1.6
-# Spring Beans
+= Spring Beans
The following beans are usable in any spring xml file.
@@ -106,12 +106,12 @@ interface of each EJB, but explicit use can be nice if you desire to
import an EJB with a specific name. Has the following properties:
_deploymentId_, _interface_
-# Examples
+= Examples
See the link:spring-ejb-and-jpa.html[Spring EJB and JPA] page for
example code and a working Spring xml file.
-# \{anchor:problems} Problems?
+= \{anchor:problems} Problems?
If you are having problems with the installation, please send a message
to the OpenEJB users link:mailing-lists.html[mailing list] containing
@@ -122,7 +122,7 @@ any error message(s) and the following information:
* Java Version (execute java -version)
* Operating System Type and Version
-# Limitations
+= Limitations
_JavaAgent_ - OpenEJB uses OpenJPA to provide JPA and CMP persistence,
and OpenJPA currently requires a JavaAgent to function properly in a
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/ssh.adoc
----------------------------------------------------------------------
diff --git a/docs/ssh.adoc b/docs/ssh.adoc
index fd09c95..42750f5 100644
--- a/docs/ssh.adoc
+++ b/docs/ssh.adoc
@@ -1,4 +1,4 @@
-# SSH
+= SSH
:index-group: Unrevised
:jbake-date: 2018-12-05
:jbake-type: page
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/standalone-server.adoc
----------------------------------------------------------------------
diff --git a/docs/standalone-server.adoc b/docs/standalone-server.adoc
index d9c0867..87e4db7 100644
--- a/docs/standalone-server.adoc
+++ b/docs/standalone-server.adoc
@@ -17,7 +17,7 @@ CONDITIONS OF ANY KIND, either express or implied. See the License for
the specific language governing permissions and limitations under the
License.
-#Links to guide you through OpenEJB-Standalone-Server
+= Links to guide you through OpenEJB-Standalone-Server
* link:startup.html[Startup]
* link:deploy-tool.html[Deploy Tool]
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/startup.adoc
----------------------------------------------------------------------
diff --git a/docs/startup.adoc b/docs/startup.adoc
index a162f2e..4e5a7ac 100644
--- a/docs/startup.adoc
+++ b/docs/startup.adoc
@@ -1,18 +1,18 @@
-# Startup
+= Startup
:index-group: OpenEJB Standalone Server
:jbake-date: 2018-12-05
:jbake-type: page
:jbake-status: published
-# NAME
+= NAME
openejb start - OpenEJB Remote Server
-# SYNOPSIS
+= SYNOPSIS
openejb start link:#options.html[#options]
-# NOTE
+= NOTE
The OpenEJB Remote Server can be started by running the openejb.bat
script for windows and the openejb script for Linux and other Unix based
@@ -45,7 +45,7 @@ in shorthand as show below.
_openejb start -help_
-# DESCRIPTION
+= DESCRIPTION
Starts OpenEJB as an EJB Server that can be accessed by remote clients
via the OpenEJB Remote Server.
@@ -61,7 +61,7 @@ OpenEJB itself is configured with the OpenEJB configuration file, which
is extremely simple and self-documenting. This file is located at
c:-3.0.xml.
-# OPTIONS
+= OPTIONS
| _-D=_ | Specifies a system property passed into OpenEJB at startup. |
| _--admin-bind _ | Sets the host to which the admin service should be
@@ -82,7 +82,7 @@ to which the telnet service should be bound.| | _--telnet-port _ | Sets
the port to which the telnet service should be bound.| | -v, --_version_
| Print the version. |
-# EXAMPLES
+= EXAMPLES
== Example: Simplest scenario
@@ -254,7 +254,7 @@ _openejb start -Dtelnet.disabled=true_
Prevents the Telnet Server Service from starting when the OpenEJB Server
starts.
-# CONSOLE OUTPUT
+= CONSOLE OUTPUT
Once you start OpenEJB using the _openejb start_ command the following
output will be seen on the console
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/statefulcontainer-config.adoc
----------------------------------------------------------------------
diff --git a/docs/statefulcontainer-config.adoc b/docs/statefulcontainer-config.adoc
index cdf8f22..3137b0c 100644
--- a/docs/statefulcontainer-config.adoc
+++ b/docs/statefulcontainer-config.adoc
@@ -1,4 +1,4 @@
-# StatefulContainer Configuration
+= StatefulContainer Configuration
:index-group: Unrevised
:jbake-date: 2018-12-05
:jbake-type: page
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/statelesscontainer-config.adoc
----------------------------------------------------------------------
diff --git a/docs/statelesscontainer-config.adoc b/docs/statelesscontainer-config.adoc
index cc35b20..60d1b2f 100644
--- a/docs/statelesscontainer-config.adoc
+++ b/docs/statelesscontainer-config.adoc
@@ -1,4 +1,4 @@
-# StatelessContainer Configuration
+= StatelessContainer Configuration
:index-group: Unrevised
:jbake-date: 2018-12-05
:jbake-type: page
http://git-wip-us.apache.org/repos/asf/tomee/blob/94d4dfa2/docs/system-properties-files.adoc
----------------------------------------------------------------------
diff --git a/docs/system-properties-files.adoc b/docs/system-properties-files.adoc
index ec742bf..8779623 100644
--- a/docs/system-properties-files.adoc
+++ b/docs/system-properties-files.adoc
@@ -1,4 +1,4 @@
-# System Properties Files
+= System Properties Files
:index-group: Unrevised
:jbake-date: 2018-12-05
:jbake-type: page