org.apache.log4j.DailyRollingFileAppender sebagai appender. Class tersebut telah ada dalam library Log4J, jadi kita bisa langsung menggunakannya.
Bisnis content untuk telepon selular di Indonesia saat ini sangat besar. Hal ini
membuat perusahaan content provider semakin banyak tumbuh. Perusahaan content
provider bekerja sama dengan operator selular untuk dapat menjakau konsumennya. Di
Indonesia protokol yang digunakan oleh content provider untuk menerima atau
mengirimkan SMS kebanyakan dibuat sendiri oleh operator dan tidak standar.
Operator-operator biasanya menggunakan protokol sendiri dengan alasan kesederhanaan
dan kemudahan. Operator yang menggunakan protokol standar untuk menerima dan mengirim
SMS biasanya menggunakan protokol SMPP. Artikel ini membahas secara singkat tentang
protokol MMAP/SMAP yang merupakan alternatif protokol untuk menerima atau mengirim
SMS antar operator dan content provider.
-= Definisi =-
MMAP (Mobile Messaging Access Protocol) mendefinisikan seatu cara untuk melakukan
pertukaran pesan bergerak (mobile message) menggunakan SOAP. MMAP hanya
mendefinisikan bagain bagaimana koneksi antara dua entitas dan suatu mobile message
dipertukarkan, oleh karenanya MMAP disebut SOAP access framework. MMAP dapat
digunakan untuk melakukan pertukan data XML yang anda buat sendiri, tetapi biasanya
MMAP digunakan sebagai pembungkus protokol SMAP. Format MMAP mengikuti standar SOAP
1.2 dan biasanya menggunakan HTTP sebagai transport protokolnya. MMAP menggunakan
tidak menggunakan model SOAP RPC tetapi menggunakan SOAP messaging model (document
model).
-= SMAP =-
SMAP adalah suatu set XML elemen untuk mengirimkan, menerimana dam me-manage suatu
pesan singkat (SMS). SMAP hanya mendefinikan suatu set XML dokumen (elemen) tapi
tidak mendefinisikan bagaimana XML dokumen tersebut dipertukarkan. SMAP dapat
dimasukan (embed) dalam MMAP sehingga menjadi protokol yang lengkap untuk pertukaran
data SMS.
-= Menggapa menggunakan MMAP/SMAP? =-
Dibandingkan dengan protokol yang dibuat sendiri (proprietary protocol), MMAP
merupakan standar terbuka sehingga memudahkan untuk dikuti semua operator dan content
provider.
Dibandingkan SMPP yang merupakan binary protokol, MMAP lebih mudah dipelajari dan
dibuat implementasinya karena MMAP berbasiskan SOAP (teks). Hal ini juga membuat MMAP
mudah di-debug.
-= Alasan untuk belum menggunakan MMAP? =-
Dibanding proprietary protocol, tentu saja MMAP/SMAP lebih lengkap dan lebih rumit
untuk diimplementasikan. Selain itu, library untuk MMAP/SMAP yang gratis sejauh ini
belum ada. Hal ini berbeda dengan SMPP, library untuk SMPP yang gratis banyak
terdapat di internet sehingga akan memudahkan developer untuk menggunakan protokol
SMPP.
-= Penggunaan MMAP/SMAP =-
Ilustrasi penggunakan MMAP dan SMAP dapat dilihat pada gambar dibawah ini.
-------------------------------
| ,---------. ,---------. |
| | Message | | | | ,----------.
| | center |<---->| SMS | | MMAP/SMAP | |
| | (SMSC) | | Gateway | |<---------->| Aplikasi |
| `---------' | Function| | | |
| | | | `----------'
| `---------' |
| Mobile message service |
-------------------------------
- Mobile center adalah elemen yang bertanggung jawab untuk meneruskan pesan ke tujuan
misalnya nomor telepon selular seseorang.
- SMS gateway function adalah elemen yang memberikan layanan koneksi terhadap
aplikasi atau elemen lain yang akan menggirimkan pesan. SMS gateway function tersebut
bisa jadi telah ada dalam message center (SMSC) sehingga bukan merupakan elemen
terpisah dari message center.
- Aplikasi merupakan elemen yang membutuhkan layanan untuk dapat mengirim atau
menerima pesan. Aplikasi pada diagram diatas biasanya adalah aplikasi eksternal yang
dibuat oleh rekanan dari operator misalnya content provider. Karena MMAP/SMAP
merupakan standar terbuka dan gratis, content provider dapat dengan mudah
menggunakannya untuk mengirimkan atau menerima pesan (content) kepada pelanggannya.
-= Struktur MMAP =-
MMAP memiliki 2 bagian yaitu:
1. MMAP header
MMAP header berisi informasi application context misalnya, session, kontrol akses
(username dan password), billing, dan parameter-parameter lain yang bisa ditambahan.
MMAP header berada pada SOAP header. Contoh MMAP header:
<MMAP:MMAPHeader soap:mustUnderstand="1"
xmlns:MMAP="http://www.smsforum.net/schemas/mmap/v1.0"
xsi:schemaLocation="http://www.smsforum.net/schemas/mmap/v1.0
http://www.smsforum.net/schemas/mmap/v1.0/mmap.xsd">
<MMAP:ApplicationContext bodyType="Request" sourceOperationReference="123"/>
<MMAP:AccessControl>
<MMAP:ApplicationIdentity>testApp</mmap:ApplicationIdentity>
<MMAP:Authentication>
<MMAP:Password>secret</mmap:Password>
</MMAP:Authentication>
</MMAP:AccessControl>
<MMAP:ServiceContext serviceName="test"/>
</MMAP:MMAPHeader>
2. Request/response MMAP data.
MMAP data berada pada SOAP body yang membawa informasi standar untuk operasi request
dan response.
Fungsi MMAP sebagai access framework yang hanya menspesifikasikan operasi untuk
me-maintain koneksi atau session saja, tergambar dari semua XML data elemen yang
dimilikinya berikut ini:
BindRequest,
BindResponse/BindBackResponse,
BindBack request,
UnbindRequest,
UnbindResponse,
BatchRequest,
BatchResponse,
BatchResult request,
EnquireLink request,
EnquireLinkResponse,
SuccessResponse,
ErrorResponse
Dibawah ini adalah contoh suatu SOAP message yang menunjukan tempat bagian MMAP
berada:
<?xml version="1.0" encoding="UTF-8"?>
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.w3.org/2003/05/soap-envelope
http://www.w3.org/2003/05/soap-envelope">
<soap:Header>
<!-- MMAP header disini -->
</soap:Header>
<soap:Body>
<!- MMAP data element disini -->
</soap:Body>
</soap:Envelope>
-= Mode Operasional MMAP =-
Ada 4 mode operasional hubungan antar aplikasi dengan message service pada MMAP,
yaitu:
1. Mode Immediate.
Pada mode ini aplikasi tidak menyimpan session untuk koneksifitas dengan mobile
message service. Mobile message service hanya mengirimkan respon hanya jika diminta.
Mode ini dapat digunakan untuk mengirimkan pesan saja. Pesan berada di SOAP body
element dan operasi MMAP tidak diperlukan pada mode ini.
2. Mode client-session.
Pada mode ini aplikasi menyimpan (maintain) session dengan message service dengan
cara mengirimkan bind request. Setiap SOAP message yang kirim berisi sebuah
application context yang mengidentidikasikan session yang dimiliki client.
Proses ini diawali dengan client menggirimkan BindRequest ke message service. Pada
element BindRequest, sessionType parameter pada elemen SessionControl berisi
"client". Message service meresponse dengan membawa informasi session ID pada MMAP
header dan elemen BindResponse pada SOAP body.
Setelah melakukan proses bind, maka client dapat melakukan pengiriman pesan. Mode ini
diakhiri client dengan mengirimkan UnbindRequest ke message service dan message
service akan mengirimkan UnbindResponse pada client.
3. Mode Peer-to-peer
Pada mode ini, aplikasi dan message service melakkan session dua arah (bi-directional
session) sehingga komunikasi dapat dilakukan secara asynchronous. Message service
akan memberikan respon segera setelah menerima pesan dari client. Respon tersebut
hanya mengindikasikan bahwa message service telah menerima pesan. Setelah pesan
diproses makan message service akan mengirimkan respon lagi kepada client.
Proses ini diawali dengan client menggirimkan BindRequest ke message service. Berbeda
dengan mode client-session, pada mode ini sessionType parameter berisi "peer".
Kemudian message service akan meresponse dengan BindResponse dan informasi session IF
pada MMAP header. Selain merespon BindRequest, message service dengan segera juga
akan mengirimkan BindBackRequest ke client. Client atau aplikasi akan merespon
BindBackRequest dengan BindBackResponse dan menginformasikan session ID pada MMAP
header.
Mode ini diakhiri dengan pengiriman UnbindRequest dari client ke message service dan
sebaliknya.
4. Mode batch
Pada mode ini, message service menerimana satu set MMAP request untuk diproses.
Aplikasi mengirimkan BatchRequest ke message service dan direspon dengan BatchReponse
yang menunjukkan request telah diterima. Kemudian message service akan memproses
setiap operasi yang ada dalam batch request. Setelah selesai semua operasi, message
service akan mengirimkan BatchResult request yang berisi status hasil tiap-tiap
proses. Client menerima BatchResult result dan meresnponse dengan SuccessResponse.
-= Contoh =-
Berikut ini adalah contoh pesan MMAP/SMAP lengkap untuk mengirimkan SMS menggunakan
mode immediate:
<?xml version="1.0" encoding="UTF-8"?>
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.w3.org/2003/05/soap-envelope
http://www.w3.org/2003/05/soap-envelope">
<soap:Header>
<MMAP:MMAPHeader soap:mustUnderstand="1"
xmlns:MMAP="http://www.smsforum.net/schemas/mmap/v1.0"
xsi:schemaLocation="http://www.smsforum.net/schemas/mmap/v1.0
http://www.smsforum.net/schemas/mmap/v1.0/mmap.xsd">
<MMAP:ApplicationContext bodyType="Request" sourceOperationReference="123"/>
<MMAP:ServiceContext serviceName="test"/>
</MMAP:MMAPHeader>
</soap:Header>
<soap:Body>
<smap:SubmitRequest xmlns:smap="http://www.smsforum.net/schemas/smap/v1.0"
xsi:schemaLocation="http://www.smsforum.net/schemas/smap/v1.0
http://www.smsforum.net/schemas/smap/v1.0/smap.xsd">
<smap:ShortMessage>
<smap:Header>
<smap:Destination>
<smap:Number>+12345679</smap:Number>
</smap:Destination>
</smap:Header>
<smap:Body>
<smap:Text>Hello world</smap:Text>
</smap:Body>
</smap:ShortMessage>
</smap:SubmitRequest>
</soap:Body>
</soap:Envelope>
-= Penutup =-
Penjelasan yang lebih detail tentang MMAP dapat dibaca pada dokumen spesifikasinya
yang dapat di download dari:
http://smsforum.net/doc/download.php?id=smppv34 (versi 3.4)
http://smsforum.net/doc/download.php?id=smppv50 (versi 5.0)
Untuk implementasi MMAP/SMAP, situs tersebut juga menyediakan file XML schema untuk
MMAP maupun SMAP yang dapat didownload secara terpisah.
<smil>
<body>
<par dur="10000ms">
<text src="deskripsi.txt"></text>
<audio src="deskripsi.rm"></audio>
<img src="deskripsi.jpg"></img>
</par>
</body>
</smil>
</code>
ssh-rsa AAAAB3NzaC1yc2EAAAABJQAAAIBMFXliQrC16kZwFH1YOl/n3leI5aK13gFYiPFKFSBCFikNzJL5Su9PrJB0fJ7ZgSHKc/2
s+tWaXvfS6yWsGTQ81T49YidfQu/M14QgHTvpe23h8NaBRr+HuxDil0euUnolOcFchXraS5APe+yrqNIKSotGAxpfyPDpXTAZsAgdhQ==
rsa-key-20061115
Port 4321
Protocol 2
PasswordAuthentication no
AllowTcpForwarding yes
AllowUsers cvsadmin
/usr/sbin/sshd -f /etc/ssh/sshd_config_ext
MERGE INTO app_user dest
USING (SELECT ? AS userid, ? AS first_name FROM dual) src
ON (dest.userid = src.userid)
WHEN MATCHED THEN
UPDATE SET dest.first_name = src.first_name
WHEN NOT MATCHED THEN
INSERT (dest.userid, dest.first_name)
VALUES (src.userid, src.first_name)
-== Pengenalan SAX ==-
SAX (Simple API for XML) adalah API (common interface) untuk memparsing XML dokumen secara event-based.
SAX bukanlah sebuah XML parser. SAX didesain untuk dapat digunakan dengan berbagai macam event-based parser.
SAX tidak sulit dipelajari, karena sifatnya yang simpel.
SAX API cukup kecil, hanya terdiri 35 class/interface yang terdapat dalam 3 package:
org.xml.sax
org.xml.sax.ext
org.xml.sax.helpers
-== Event-based API ==-
Pada event-based API,suatu even akan dilemparkan lewat callback jika parser membaca karakter data atau awal/akhir
dari dokumen maupun element/tag.Kita harus membuat (mengimplementasikan) handler yang akan menangani event. Dengan
event-based API, akses ke XML dokumen menjadi lebih cepat dan sederhana. Juga dimungkinakan untuk memparsing
dokumen yang besar dari memori sistem yang tersedia karena struktur dokumen tidak disimpan dalam memori.
Catatan
Untuk yang belum tahu, selain parser yang event based ada juga parser XML yang DOM based dan pull streaming based.
Ketiga macam parser tersebut dibedakan dengan caranya memproses dokumen XML dan masing masing memiliki kelebihan dan
kekurangan.
-== Beberapa Java SAX2 parser ==-
Xerces http://xml.apache.org/xerces-j/index.html
Sun's JAXP http://java.sun.com/xml/
SAXON XSLT processor http://users.iclway.co.uk/mhkay/saxon/
Oracle XML Developer's Kit for Java http://technet.oracle.com/tech/xml/xdk_java.html
ParserAdapter http://www.megginson.com/SAX/Java/index.html
-== Menggunakan SAX ==-
Untuk dapat melakukan parsing pada XML dokumen kita membutuhkan class yang mengimplentasikan interface XMLReader.
XMLReader bertanggung jawab untuk mem-parsing dokumen XML.
Implemantasi interface org.xml.sax.XMLReader dapat di-instantiate dengan cara:
XMLReader xr = (XMLReader) Class.forName("org.apache.xerces.parsers.SAXParser").newInstance();
atau
XMLReader xr = new org.apache.xerces.parsers.SAXParser();
atau
XMLReader xr = org.xml.sax.helpers.XMLReaderFactory.createXMLReader();
Dianjurkan kita menggunakan cara yang terakhir, karena tidak tergantung pada suatu implementasi parser tertentu.
Dengan cara yang terakhir, XMLReader didapatkan dari class pada saat runtime dengan membaca setting pada:
- System property "org.xml.sax.driver" yang dispesifikasikan pada command line seperti
java -Dorg.xml.sax.driver=org.apache.xerces.parsers.SAXParser JavaProgram
atau pada kode program seperti
System.setProperty("org.xml.sax.driver", "org.apache.xerces.parsers.SAXParser");
- Atau pada file META-INF/services/org.xml.sax.driver didalam JAR file
XMLReader membutuhkan class handler yang harus mengimplementasikan interface berikut:
- ContentHandler yang akan meng-handle jika terjadi event pada saat proses parsing
- ErrorHandler yang akan meng-handle jika terjadi warning/error
- DTDHandler yang akan meng-handle event pada dkumen DTD
- EntityResolver yang akan men jika ada external entities pada dokument XML (misalnya external DTD atau external
parameter entity)
Untuk mengimplementasikan handler diatas sebaiknya gunakan DefaultHandler sebagai base class.
DefaultHandler telah mengimplementasikan keempat interface diatas.
Method signature dari ContentHandler (atau Defaulthandler) yang penting untuk memproses dokumen XML diantaranya:
* void characters(char[] ch, int start, int length)
* void endDocument()
* void endElement(String uri, String localName, String rawName)
* void startDocument()
* void startElement(String uri, String localName, String rawName, Attributes attributes)
Dibawah ini contoh code penggunaan DefaultHandler sebagai base class yang hanya mengimplementasikan method-method
ContentHandler:
public class MyDefaultHandler extends DefaultHandler {
public void startElement(java.lang.String uri, String localName, String qName, Attributes attributes)
throws SAXException {
System.out.print("Start element: URI = " + uri +
", localname = " + localName +
", qname = " + qName +
", attributes = {" );
for (int i = 0; i < attributes.getLength(); i++) {
System.out.print( attributes.getQName(i) + "(" + attributes.getType(i) + ") = " +
attributes.getValue(i) + ", ");
}
System.out.println("}");
}
public void characters(char[] ch, int start, int length) throws SAXException {
System.out.println("characters: " + ch);
}
public void endElement(String uri, String localName, String qName) throws SAXException {
System.out.println("End element: URI = " + uri + ", localname = " + localName + ", qname = " + qName);
}
}
XML memerlukan class InputSource sebagai input dalam melakukan parsing.
InputSource adalah representasi dari XML dokumen yang kemudian di-parsing oleh XMLReader.
XML dokumen dapat berada di lokal maupun remote dan URI digunakan sebagai parameter constructor dari class InputSource.
FileInputStream is = new FileInputStream("C:/Users.xml");
xmlReader.setContentHandler(myDefaultHandler);
xmlReader.parse(new InputSource(is));
-== Perubahan class pada SAX1 ke SAX2 ==-
Saat ini SAX terbaru adalah versi 2, biasa ditulis SAX2 dan SAX versi sebelumnya biasa ditulis SAX1.
Ada beberapa perbedaan antara SAX1 dan SAX2 walaupun demikian parser yang mengimplementasikan SAX1 yaitu class Parser
masih dapat digunakan oleh SAX2, demikian juga sebaliknya.
Dibawah ini adalah table class yang berubah pada SAX1 ke SAX2
-------------------------------------
Class pada SAX1 Class pada SAX2
================= ===================
ParserFactory XMLReaderFactory
Parser XMLReader
DocumentHandler ContentHandler
HandlerBase DefaultHandler
AttibuteList Attributes
-------------------------------------
Parser dari SAX1 dapat digunakan pada sebagai SAX2 XMLReader dengan menggunakan class ParserAdapter
SAX2 XMLReader juga dapat digunakan sebagai XA1 Parser dengan menggunakan class XMLReaderAdapter
-== Contoh kode yang lengkap ==-
public class MyDefaultHandler extends DefaultHandler {
public static void main(String[] args) {
try
FileInputStream is = new FileInputStream("C:/Users.xml");
XMLReaderFactory fact = XMLReaderFactory.newInstance();
XMLReader xmlReader = parser.createXMLReader();
xmlReader.setContentHandler(this);
xmlReaderreader.setErrorHandler(this);
xmlReader.setFeature("http://xml.org/sax/features/validation" ,true);
xmlReader.setEntityResolver(this);
xmlReader.parse(new InputSource(is));
} catch (Exception e) {
e.printStackTrace();
}
}
public void startElement(java.lang.String uri, String localName, String qName, Attributes attributes)
throws SAXException {
System.out.print("Start element: URI = " + uri +
", localname = " + localName +
", qname = " + qName +
", attributes = {" );
for (int i = 0; i < attributes.getLength(); i++) {
System.out.print( attributes.getQName(i) + "(" + attributes.getType(i) + ") = " +
attributes.getValue(i) + ", ");
}
System.out.println("}");
}
public void characters(char[] ch, int start, int length) throws SAXException {
System.out.println("characters: " + ch);
}
public void endElement(String uri, String localName, String qName) throws SAXException {
System.out.println("End element: URI = " + uri + ", localname = " + localName + ", qname = " + qName);
}
}
-== Menggunakan JAXP (versi 1.1) ==-
Pada JAXP, XMLReader dibungkus (wrap) oleh class lain yaitu javax.xml.parsers.SAXParser yang dapat diperoleh dari
factory class yaitu javax.xml.parsers.SAXParserFactory. Dibawah ini contoh kode untuk mendapatkan instance dari class
SAXParser:
SAXParserFactory factory = SAXParserFactory.newInstance();
SAXParser parser = factory.newSAXParser();
Class SAXParser sudah cukup untuk dapat melakukan parsing pada XML dokumen, yaitu dengan menggunakan method
parse(InputSource, DefaultHandler). Jika menginginkan mendapatkan class XMLReader, kita dapat memanggil method
getXMLReader() pada class SAXParser.
SAXParserFactory adalah class abstract, implementasinya didapatkan dari metode lookup yaitu:
- Menggunakan system property "javax.xml.parsers.SAXParserFactory"
- Menggunakan standar java properties file yang ada di "lib/jaxp.properties" pada direktori JRE
- Menggunakan service API yaitu pada file META-INF/services/javax.xml.parsers.SAXParserFactory di dalam file JAR
- Default instance yang ada pada platform
public abstract Encryptor getEncryptor(String s);
public class DESEncryptor extends com.ejlp.spi.EncryptorProvider {
public DESEncryptor() {}
public abstract Encryptor getEncryptor(String s) {
//...
}
}
#Provider for DES encryptor com.ic.DESEncryptor
static {
for (Iterator i = Service.providers(EncryptorProvider.class); i.hasNext(); ) {
EncryptorProvider ep = (EncryptorProvider) i.next();
registerProvider(ep.class.getName, ep);
}
}
registerProvider(String name, EncryptorProvider ep) {
//... Add provider to a Map
}
Encryptor getEncryptor(String providerName) {
//... get provider by its name, otherwise get default provider
}
javax.management.remote
javax.management.remote.generic (optional package)
javax.management.remote.jmxmp (optional package)
javax.management.remote.message (digunakan untuk wrapping object yang dikirim dari client ke server)
javax.management.remote.rmi (mandatory package)
MBeanServer mbs = MBeanServerFactory.createMBeanServer();
JMXServiceURL url = new JMXServiceURL("service:jmx:rmi:///jndi/rmi://localhost:9999/server");
Map environment = null;
JMXConnectorServer cs = JMXConnectorServerFactory.newJMXConnectorServer(url, environment, mbs);
cs.start();
JMXServiceURL url = new JMXServiceURL("service:jmx:rmi:///jndi/rmi://localhost:9999/server");
Map environment = null;
JMXConnector connector = JMXConnectorFactory.newJMXConnector(url, environment);
connector.connect(connectionEnvironment);
// Obtain a "stub" for the remote MBeanServer
MBeanServerConnection mbsc = connector.getMBeanServerConnection();
// Call the remote MBeanServer
String domain = mbsc.getDefaultDomain()
int initialDelay = 30000; // start after 30 seconds
int period = 5000; // repeat every 5 seconds
Timer timer = new Timer();
TimerTask task = new TimerTask() {
public void run() {
// job code here
}
};
timer.scheduleAtFixedRate(task, initialDelay, period);
static protected ClockDaemon clockDaemon = new ClockDaemon();
static
{
log.debug("Setting the clockDaemon's thread factory");
clockDaemon.setThreadFactory(new ThreadFactory()
{
public Thread newThread(Runnable r)
{
Thread t = new Thread(getThreadGroup(), r, "ThreadDaemon");
t.setDaemon(true);
return t;
}
});
}
public static ThreadGroup getThreadGroup()
{
if (threadGroup.isDestroyed())
threadGroup = new ThreadGroup("Our Threads");
return threadGroup;
}
public static void main(String[] args)
{
int period = 500; //millis
clockDaemon.executePeriodically(
period,
new Runnable() {
public void run() {
System.out.println("Running...");
}
},
true);
}
logger.debug("The new entry is {}. It replaces {}.", object, oldObject);
logger.debug("Value {} was inserted between {} and {}.",
new Object[] {newVal, below, above});
