twitter/cloudhopper-commons

Cloudhopper Commons

Cloudhopper by Twitter

Common Java libraries used by the Cloudhopper family of mobile messaging applications at Twitter.

cloudhopper-commons-charset

Utility Java classes for converting between charsets (mostly "mobile" in nature) such as Unicode to GSM and vice versa. This library attempts to contain the fastest and most efficient methods for converting charsets to/from byte arrays.

cloudhopper-commons-gsm

Utility Java classes for working with GSM mobile technologies (usually SMS or MMS).

cloudhopper-commons-io

I/O utilities. Currently useful for file watching, reading and writing.

cloudhopper-commons-locale

Localization utilities for Cloudhopper projects. Country, country code and timezone utilities.

cloudhopper-commons-rfs

Cloudhopper Commons RFS supports copying and moving files to remote filesystems. Various protocols are supported such as FTP, SSL/TLS FTP, Secure FTP, and possibly more in the future. Each is configured with a simple URL-based syntax. Authentication is supported for each protocol.

cloudhopper-commons-sql

Provides a consistent interface to configure, create, and manage (via JMX) various DataSource providers that may provide Connection pooling. Currently supports C3P0 and Proxool.

cloudhopper-commons-util

Utility Java classes commonly used across all Cloudhopper-based projects.

cloudhopper-commons-xbean

The Xbean Java library is a set of utility classes for creating or configuring a Java object from XML. The library is a simple alternative to other XML-to-Java frameworks such as Spring. The library will only map in a single direction - XML -> Java. This limited scope helps keep this library small, fast, and very good at what it was mainly intended for -- application configuration files.

cloudhopper-httpclient-util

Apache Jakarta HttpClient 4.x utility library.

cloudhopper-jetty

Wrapper around Jetty HTTP Server that makes configuration easy and possible from a simple few configuration objects.

cloudhopper-sxmp

Library implementing the SXMP protocol. SXMP is like SMPP, but as readable XML.

cloudhopper-commons-ssl

Utility Java classes for working with SSL in Cloudhopper-based projects. Originally part of cloudhopper-smpp.

Installation

Library versions are now published to the Maven Central Repository. Just add the following dependency to your project maven pom.xml:

<dependency>
  <groupId>com.cloudhopper</groupId>
  <artifactId>ch-artifact-name</artifactId>
  <version>version.number</version>
</dependency>

Demo Code / Tutorials

Most of the modules contain examples of how to use various parts of the libraries in the demo package of the test sources. Additionally, some of the modules have a simple Makefile that simplify running demos.

License

Copyright (C) 2010-2014 Twitter, Inc.

This work is licensed under the Apache License, Version 2.0. See LICENSE for details.

cloudhopper-commons's Issues

Endianness Converter

Would it be ok if I submitted a PR which adds the following method to CharsetUtil? I the SMSC that I'm connecting too uses LittleEndian for UCS-2

  static public byte[] getEndianBytes(byte [] sourceBytes, ByteOrder destByteOrder) {
    ByteBuffer sourceByteBuffer = ByteBuffer.wrap(sourceBytes);
    ByteBuffer destByteBuffer = ByteBuffer.allocate(sourceBytes.length);

    destByteBuffer.order(destByteOrder);
    while(sourceByteBuffer.hasRemaining()) {
      destByteBuffer.putShort(sourceByteBuffer.getShort());
    }

    return destByteBuffer.array();
  }

WindowFuture - add listener for async notification on complete, fail etc

Like ListenableFuture (guava).
https://code.google.com/p/guava-libraries/wiki/ListenableFutureExplained

Add Travis CI support

Add CONTRIBUTING.md

GitHub supports contributing guidelines:
https://github.com/blog/1184-contributing-guidelines

We should add some to this repository. Here are some examples:
https://github.com/twitter/CocoaSPDY/blob/master/CONTRIBUTING.md
https://github.com/twitter/scalding/blob/develop/CONTRIBUTING.md

No public tags?

Currently there are no pushed tags:
https://github.com/twitter/cloudhopper-commons/releases

Would recommend using GitHub release feature for pretty releases (tags):
https://github.com/blog/1547-release-your-software

HPRoman8 charset support just like GSM7

I am trying to send MT message with HPRoman8 characters. It is not encoded properly as the message lies under GSM family.
Text: £100 €1000 e.mail@address

After CharsetUtil.decode I am seeing "100 e1000 e.mailaddress"

£ and € signs are missing

Map of Byte Array to Charset or CharsetName

I'm trying to decode a MO message using CharsetUtil.decode but I don't know the dataCoding in advance. I can't seem to find a mapping between the dataCoding byte to the Charset or CharsetName

      DeliverSm mo = (DeliverSm) pduRequest;
      byte dataCoding = mo.getDataCoding();
      byte[] shortMessage = mo.getShortMessage();
      // in the following line how can I get the CharsetName from dataCoding
      String messageText = CharsetUtil.decode(shortMessage, "UCS-2");

Am I missing something simple here?

ch-httpclient-util 1.5.1 jar published with javadocs rather than classes

The 1.5.1 jar published for ch-httpclient-util is unusable as it's got html client rather than compiled classes. I noticed this for 1.5.1 of ch-sxmp as well (that one has a newer, working version)

https://repo1.maven.org/maven2/com/cloudhopper/ch-httpclient-util/1.5.1/

META-INF/
META-INF/MANIFEST.MF
com/
com/cloudhopper/
com/cloudhopper/httpclient/
com/cloudhopper/httpclient/util/
com/cloudhopper/httpclient/util/class-use/
resources/
allclasses-frame.html
allclasses-noframe.html
com/cloudhopper/httpclient/util/class-use/DoNotVerifySSLCertificateTrustManager.html
com/cloudhopper/httpclient/util/class-use/HttpClientFactory.html
com/cloudhopper/httpclient/util/class-use/HttpClientUtil.html
com/cloudhopper/httpclient/util/class-use/PreemptiveBasicAuthHttpRequestInterceptor.html
com/cloudhopper/httpclient/util/class-use/SchemeFactory.html
com/cloudhopper/httpclient/util/class-use/UnexpectedHttpStatusCodeException.html
com/cloudhopper/httpclient/util/class-use/Version.html
com/cloudhopper/httpclient/util/DoNotVerifySSLCertificateTrustManager.html
com/cloudhopper/httpclient/util/HttpClientFactory.html
com/cloudhopper/httpclient/util/HttpClientUtil.html
com/cloudhopper/httpclient/util/package-frame.html
com/cloudhopper/httpclient/util/package-summary.html
com/cloudhopper/httpclient/util/package-tree.html
com/cloudhopper/httpclient/util/package-use.html
com/cloudhopper/httpclient/util/PreemptiveBasicAuthHttpRequestInterceptor.html
com/cloudhopper/httpclient/util/SchemeFactory.html
com/cloudhopper/httpclient/util/UnexpectedHttpStatusCodeException.html
com/cloudhopper/httpclient/util/Version.html
constant-values.html
deprecated-list.html
help-doc.html
index-all.html
index.html
overview-tree.html
package-list
resources/background.gif
resources/tab.gif
resources/titlebar.gif
resources/titlebar_end.gif
serialized-form.html
stylesheet.css