This document discusses the implementation of bundles in an OSGi framework. It includes sections on bundle management, an event bundle that broadcasts emergency messages, code examples for a simple bundle and accessing services via PMP, and links to documentation on OSGi frameworks like Knopflerfish and Equinox. Code snippets show how to create bundles with a thread, activator, and manifest, access services, and send broadcast datagrams for events.

1. Balduran chang
2008/9/30
Balduran.cs96g@g2.nctu.edu.tw
EC719
(03)5712121#54819

2.  Bundle management portion
 GUI
 Bundle list
 un/install bundle
 Start/stop bundle
 Update/configre bundle
 EV bundle portion
 one trigger function to broadcast “Emergency event!”
 once receive EV message, response it and show
incoming message.
 Port number and message should be able to modify

3.  PPT slice
 Architectures
 System design
 Used module
 Source code
 Java code
 Jar file

4.  Knopflerfish
 http://www.knopflerfish.org/download.html
 Apache Felix
 http://felix.apache.org/site/downloads.cgi
 Equinox
 http://download.eclipse.org/equinox/
 Prosyst mBedded Server Equinox Edition
 http://dz.prosyst.com/oss/

5.  Install
 Use startinstall.bat
 Start framework
 C:mbs_equinoxbinv
msjdkserver.bat

6.  install
 uninstall
 start
 stop
 refresh
 update
 status
 ss
 services
 bundles
 bundle
 headers
 log
 gc
 sl
 exit
 init
 shutdown

7.  install file:../../../demo/bundles/httpdemo.jar
 start <bundle id>
 Check the bundle status is active
 Visit
http://<mbs_host>/images/imagination.jpg

8.  Stop <bundle id>
 Check the bundle status is resolved
 Uninstall <bundle id>

9.  JDK 1.6.07
 mBS Equinox edition 3.4
 Eclipse
 Configure build path…
 Add external JARs…
 bundles/org.eclipse.osgi.jar
 bundles/org.eclipse.osgi.services.jar
 bundles/org.eclipse.osgi.util.jar

10. 1. Bundle implementation
2. Bundle activator
3. Compile and generate class file
4. Manifest.mf file
5. Generate bundle JAR file
6. Install and start bundle

11. HelloWorldThread.java
public class HelloWorldThread extends Thread {
private boolean running = true;
public HelloWorldThread() {}
public void run() {
while (running) {
System.out.println("Hello World!");
try {
Thread.sleep(5000);
} catch (InterruptedException e) {
System.out.println("ERROR: " + e);
}
}
}
public void stopThread() {
this.running = false;
}
}

12. Activator.java
import org.osgi.framework.BundleActivator;
import org.osgi.framework.BundleContext;
public class Activator implements BundleActivator {
public static BundleContext bc = null;
private HelloWorldThread thread = null;
public void start(BundleContext bc) throws Exception {
System.out.println("Bundle starting...");
Activator.bc = bc;
this.thread = new HelloWorldThread();
this.thread.start();
}
public void stop(BundleContext bc) throws Exception {
System.out.println("Bundle stopping...");
this.thread.stopThread();
this.thread.join();
Activator.bc = null;
}
}

13. Manifest.mf
Manifest-Version: 1.0
Bundle-Name: first bundle
Bundle-SymbolicName: firstbundle
Bundle-Version: 1.0.0
Bundle-Description: first Demo Bundle
Bundle-Vendor: vendorABC
Bundle-Activator: demo.Activator
Bundle-Category: demo
Import-Package: org.osgi.framework
 Compile CMD
 javac -classpath .;../bundles/org.eclipse.osgi.jar; *.java
 Jar CMD
 jar cmf ./manifest firstbundle.jar *.class

14. Build.xml
<?xml version="1.0"?>
<project name="simplebundle" default="all">
<target name="all" depends="init,compile,jar" />
<target name="init">
<mkdir dir="./classes" />
<mkdir dir="./bin" />
</target>
<target name="compile">
<javac destdir="./classes" debug="on" srcdir="./src">
</javac>
</target>
<target name="jar">
<jar basedir="./classes" jarfile="./bin/simplebundle.jar" compress="true"
includes="**/*" manifest="./meta-inf/MANIFEST.MF" />
</target>
<target name="clean">
<delete dir="./classes" />
<delete dir="./bin" />
</target>
</project>

15. GetService.java
import org.osgi.framework.ServiceReference;
import org.osgi.framework.BundleException;
public class GetService implements BundleActivator {
ServiceReference timeRef = null;
TimeService timeService = null;
public void start(BundleContext bc) throws BundleException {
timeRef = bc.getServiceReference(TimeService.class.getName());
if (timeRef != null) {
timeService = (TimeService) bc.getService(timeRef);
}
if (timeService == null) {
return;
}
}
public void stop(BundleContext bc) throws BundleException {
if (timeRef != null) {
bc.ungetService(timeRef);
timeRef = null;
timeService = null;
}
}
}

16. public class PMPDemo implements BundleActivator {
static String SYSTEM = "com.prosyst.util.system.SystemService";
public void start(BundleContext bx) throws BundleException {
try {
ServiceReference sr =
bx.getServiceReference(PMPService.class.getName());
if(sr == null) throw new BundleException("Can't get
PMPService");
PMPService pmp = (PMPService)bx.getService(sr);
if(pmp == null) throw new BundleException("Can't get
PMPService");
Hashtable props = new Hashtable (20);
props.put("username", "admin");
props.put("password", "admin");
PMPConnection con = pmp.connect("socket://127.0.0.1:1449",
props);
RemoteObject rObject = con.getReference(SYSTEM, "");

17. String [] str = {Byte.TYPE.getName()};
RemoteMethod rMethod = rObject.getMethod("getProperties", str);
rMethod.changeReturnType(ExternalizableDictionary.class);
Dictionary obj = (ExternalizableDictionary)rMethod.invoke(new
Object[] {new Byte((byte) 3)}, true);
Enumeration enum = obj.keys();
while(enum.hasMoreElements()) {
Object tmp = enum.nextElement();
System.out.println(tmp + " " + obj.get(tmp));
}
}
catch (Exception e) {
System.out.println(e);
}
}
public void stop(BundleContext bx) {
}
}

18.  Bundle Management portion
 Use PMP (prosyst message protocol) to get a
connection to remote framework.
 1. request PMPService
 2. obtain PMPConnection
 3. call remote service method

19.  4.To make a service PMP-accessible, you should
additionally implement
the com.prosyst.util.io.Remoteinterface in the
service class.
public class example implements Remote {
public Class[] remoteInterfaces() {
}
}
Ref:
https://dz.prosyst.com/pdoc/mbs_equinox_3.4/um/framework/bundles/p
rosyst/rpc/pmp/pmpbundle.html

20.  See also:
 com.prosyst.util.parser
▪ Parser Service
▪ https://dz.prosyst.com/pdoc/mbs_prof_6.2/um/framew
ork/bundles/system/putil/putil_parser.html
 mConsole APIs
▪ https://dz.prosyst.com/pdoc/mbs_prof_6.2/um/framew
ork/admins/mConsole/mConsole_programmer.html

21.  EV bundle portion
 Java.net.DatagramSocket
▪ SO_BROADCAST
▪ setBroadcast(boolean on)
▪ getBroadcast()
 Java.net.DatagramPacket
▪ Use DatagramPacket(int port)

22.  https://dz.prosyst.com/pdoc/mbs_equinox_3.
4/um/index.html
 http://www.knopflerfish.org/tutorials.html