# smsj

**Repository Path**: xfslove/smsj

## Basic Information

- **Project Name**: smsj
- **Description**: 短彩信协议库（点评附有协议相关介绍）
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 10
- **Forks**: 2
- **Created**: 2019-10-23
- **Last Updated**: 2024-01-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

[![Maven Central](https://maven-badges.herokuapp.com/maven-central/com.github.xfslove/smsj/badge.svg)](https://maven-badges.herokuapp.com/maven-central/com.github.xfslove/smsj)
[![Gitee](https://gitee.com/xfslove/smsj/badge/star.svg)](https://gitee.com/xfslove/smsj)
[![Github](http://github-svg-buttons.herokuapp.com/star.svg?user=xfslove&repo=smsj&style=flat)](https://github.com/xfslove/smsj)

SMSJ
====

Java library implementing the 3GPP TS 23.040 and WAP-230-WSP, and allowing development of SMS or MMS and more

SMSJ is based on the [marre SMSJ](https://github.com/marre/smsj) libraries. It contains several bug fixes, and has been generally refactored, and released at maven central repository.

### Introductions

[白话短信协议](https://segmentfault.com/a/1190000020779563)    

[白话彩信协议](https://segmentfault.com/a/1190000020791435)  

[白话CMPP、SGIP](https://segmentfault.com/a/1190000020798138) ---([SMSSP](https://github.com/xfslove/smssp)的doc还在写~)

### Maven

```
<dependency>  
  <groupId>com.github.xfslove</groupId>
  <artifactId>smsj</artifactId>
  <version>1.0.1</version>
</dependency>
```

### Packages

- mms - a several models represents mms file.
- sms - a several models represents sms messages.
- wap - a several models represents wap.

### Usages

- Gsm-7bit charset

  `Gsm7BitCharset.INSTANCE`

- create SMS data coding scheme

  ```
  SmsDcs dataCodingScheme = SmsDcs.general(DcsGroup.GENERAL_DATA_CODING, SmsAlphabet.LATIN1, SmsMsgClass.Cass_1);
  ```

  ```
  SmsDcs dataCodingScheme = SmsDcs.waitingInfo(DcsGroup.MESSAGE_WAITING_STORE_UCS2, SmsWaitingInfo.VOICE);
  ```

- create SMS text message

  ```
  SmsTextMessage message = new SmsTextMessage("github");
  SmsPdu[] pdus = message.getPdus();
  
  byte[] udh = pdus[i].getUdhBytes();
  byte[] ud = pdus[i].getUdBytes();
  ```

- create WAP SI Push message

  ```
  WapSIPush push = new WapSIPush("www.github.com", "github");
  SmsWapPushMessage message = new SmsWapPushMessage(push);
  SmsPdu[] pdus = message.getPdus();
  
  byte[] udh = pdus[i].getUdhBytes();
  byte[] ud = pdus[i].getUdBytes();
  ```

- create WAP SL Push message

  ```
  WapSLPush push = new WapSLPush("www.github.com");
  SmsWapPushMessage message = new SmsWapPushMessage(push);
  SmsPdu[] pdus = message.getPdus();
  
  byte[] udh = pdus[i].getUdhBytes();
  byte[] ud = pdus[i].getUdBytes();
  ```

- create MMS Notification message

  ```
  SmsMmsNotificationMessage message = new SmsMmsNotificationMessage("http://mms-location", 0);
  message.setFrom("from");
  message.setExpiry(absolute);
  message.setTransactionId("transaction-id");
  message.setSubject("subject");
  SmsPdu[] pdus = message.getPdus();
  
  byte[] udh = pdus[i].getUdhBytes();
  byte[] ud = pdus[i].getUdBytes();
  ```

- create mixed MMS file

  ```
  MixedMms mms = new MixedMms();
  mms.setDate(shownDate);
  mms.setFrom("from");
  mms.setSubject("subject");
  mms.setTransactionId("transaction-id");
  
  mms.addBodyPart(MimeFactory.createBinaryBodyPart(imgBytes, "image/jpg"));
  mms.addBodyPart(MimeFactory.createTextBodyPart("github"));
  mms.writeTo(os);
  ```

- create related MMS file

  ```
  RelatedMms mms = new RelatedMms();
  mms.setDate(shownDate);
  mms.setFrom("from");
  mms.setSubject("subject");
  mms.setTransactionId("transaction-id");
  // px
  mms.setHeight(600);
  mms.setWidth(400);
  
  SmilRegion imgRegion = new SmilRegion(SmilRegion.IMAGE);
  // percentage
  imgRegion.setHeight(60);
  imgRegion.setWidth(100);
  imgRegion.setLeft(0);
  imgRegion.setTop(0);
  mms.addRegion(imgRegion);
  
  SmilRegion txtRegion = new SmilRegion(SmilRegion.TEXT);
  // percentage
  txtRegion.setHeight(40);
  txtRegion.setWidth(100);
  txtRegion.setLeft(0);
  txtRegion.setTop(60);
  mms.addRegion(txtRegion);
  
  SmilPar par1 = new SmilPar();
  // ms
  par1.setDur(3000);
  mms.addPar(par1);
  mms.addBodyPart(MimeFactory.createBinaryBodyPart(imgBytes, "image/jpg"), SmilRegion.IMAGE);
  
  SmilPar par2 = new SmilPar();
  par2.setDur(3000);
  mms.addPar(par2);
  mms.addBodyPart(MimeFactory.createTextBodyPart("github"), SmilRegion.TEXT);
  // notice: must one smilPar one BodyPart
  mms.writeTo(os);
  ```