Time for action - setting up the web application bundle
by Walid Joseph Gédéon
OSGi and Apache Felix 3.0
- OSGi and Apache Felix 3.0
- OSGi and Apache Felix 3.0
- Credits
- About the Author
- About the Reviewers
- Preface
- 1. Quick Intro to Felix and OSGi
- 2. Setting Up the Environment
- 3. Felix Gogo
- 4. Let's Get Started: The Bookshelf Project
- 5. The Book Inventory Bundle
- Set up the Book Inventory API Bundle project
- Time for action - setting up the project skeleton
- Time for action - creating the project POM
- The Book bean interface
- Time for action - creating the Book bean interface
- The Book Inventory interface
- Time for action - writing the BookInventory interface
- Build and deploy the bundle
- Time for action - building and deploying the bundle
- Let's implement those interfaces
- Time for action - creating the POM
- Time for action - implementing a mutable book
- Time for action - implementing the mock (memory-stored) Book Inventory
- Writing the Bundle Activator
- Time for action - add a dependency to the OSGi Core library
- Time for action - creating the Activator
- Time for action - declaring Bundle-Activator
- Build and deploy the bundle
- Summary
- 6. Using the OSGi Bundle Repository
- 7. The Bookshelf: First Stab
- The Bookshelf Service bundle
- Time for action - writing the APIs
- Time for action - writing BookshelfServiceImpl
- Time for action - implementing the service activator
- Trying the BookshelfService
- Time for action - building the bundle
- Time for action - installing and testing the service
- Time for action - fulfilling the missing dependency
- On class visibility
- Summary
- 8. Adding a Command-Line Interface
- The Apache Felix Gogo Shell Service
- Time for action - creating the Bookshelf Service TUI bundle
- Implementing a Gogo Shell Service command
- Implementing the book:search command
- Time for action - adding the required dependencies
- Time for action - writing the BookshelfServiceProxy
- Time for action - implementing a bundle activator
- Time for action - packaging and installing
- Time for action - trying out the book:search command
- Time for action - cleaning up the bookshelf-service activator
- Time for action - implementing the book-add command
- Updating an installed bundle
- Trying the commands
- Sourcing scripts
- Time for action - creating a book population script
- Summary
- 9. Improve the Bookshelf Service with iPOJO
- What is Inversion of Control?
- The iPOJO Felix sub-project
- Injecting iPOJOs
- Let iPOJO register the inventory implementation
- Time for action - creating the iPOJO metadata
- The Felix iPOJO Gogo Command bundle
- Migrate the bookshelf service
- Time for action - removing lookups in the service implementation
- Time for action - writing the bookshelf service iPOJO configuration
- iPOJO using annotations
- Update the text UI bundle
- Time for action - updating the BookshelfServiceProxyImpl
- Time for action - writing the iPOJO meta.xml
- Time for action - updating the POM
- Summary
- 10. Improving the Logging
- On logging
- The OSGi Log Service
- Apache Felix Log Service
- Creating the log helper bundles
- Time for action - creating the bookshelf-log-api bundle
- Time for action creating the log helper implementation
- Add logging to the bookshelf-service
- Time for action updating the bundle POM
- Time for action - updating the bookshelf service logging calls
- Time for action - logging to BookshelfLogHelper
- Trying it out
- Using other Log Service implementations
- Summary
- 11. How About a Graphical Interface?
- The OSGi HTTP Service
- iPOJO and the Whiteboard Extender
- Http Service implementations
- Time for action - installing the Apache Felix Http Service
- A simple bookshelf web application
- Time for action - implementing the servlet
- Time for action - declaring the parameter constants
- Time for action - implementing the operations
- Trying it out
- Summary
- 12. The Web Management Console
- 13. Improving the Graphics
- OSGi Web Containers
- Pax Web
- Time for action - installing the Pax Web bundles
- Our bookshelf-webapp
- Time for action - creating the bookshelf-webapp bundle
- Web application registration
- Time for action - setting up the web application bundle
- Time for action - specifying dependencies
- Getting a service reference in JSP
- Time for action - writing the session bean
- Time for action - using the service
- A first smoke test
- Implement the remaining pages
- Time for action - implementing the list books by category page
- Time for action - explicit package imports
- Summary
- 14. Pitfalls and Troubleshooting
- Common pitfalls
- I start my bundle but nothing happens
- I update my bundle, but I can't see any change
- I refresh my OBR but the bundles don't get updated
- The artifact JAR I need doesn't have OSGi entries in its manifest
- I get a "No impl service available" error with any shell command
- I get a "No LogReaderService available" error with the log command
- I can't add/connect to an OBR
- I'm getting a "Jsp support is not enabled" error message
- My JSP can't find a class that it needs
- Troubleshooting tips
- Summary
- Common pitfalls
- A. Eclipse, Maven, and Felix
- B. Where to Go from Here?
- C. Pop Quiz Answers
This setup is composed of two steps:
- Specifying the
Web-ContextPathOSGi manifest entry. - Optionally including a
WEB-INF/web.xmlconfiguration.
Note
The preceding are the steps based on the (recently) released OSGi Service Platform Enterprise Specification 4.2 and may be updated in the Pax Web implementation by the time you read this. In the meantime, we need to use the Webapp-Context manifest entry.
<plugin>
<groupId>org.apache.felix</groupId>
<artifactId>maven-bundle-plugin</artifactId>
<version>2.1.0</version>
<extensions>true</extensions>
<configuration>
<instructions>
<Bundle-Category>sample</Bundle-Category>
<Webapp-Context>bookshelf</Webapp-Context>
<!--
<Web-ContextPath>/bookshelf</Web-ContextPath>
-->
Tip
I've included the Web-ContextPath element (commented out) in the plugin configuration for the sake of compatibility with the specifications.
Next is the web.xml file. It is located under src/main/resources/WEB-INF/. Its contents are kept to a minimum:
<?xml version="1.0" encoding="UTF-8"?> <web-app> <display-name>Bookshelf Web-app</display-name> </web-app>
We don't need more.
Based on the bundle manifest entry (and the web.xml file), the Web Container will identify this bundle as a web application bundle and deploy its contents under the given context path. Once deployed, JSP content will be served under http://localhost:8080/bookshelf/.
So let's finish our preparation work and get to the JSP side of things.
-
No Comment
..................Content has been hidden....................
You can't read the all page of ebook, please click here login for view all page.