From 20525ff972cc7e683659191d1b096c738c479688 Mon Sep 17 00:00:00 2001 From: Alex Petrescu Date: Fri, 20 Mar 2015 11:52:51 -0700 Subject: [PATCH] Initial commit --- .gitignore | 6 + CHANGELOG.md | 8 + CONTRIBUTING.md | 44 ++++ LICENSE | 30 +++ PATENTS | 24 ++ README.md | 76 ++++++ build.gradle | 14 + connectionclass-sample/.gitignore | 1 + connectionclass-sample/build.gradle | 22 ++ .../src/main/AndroidManifest.xml | 22 ++ .../connectionclass/sample/MainActivity.java | 137 ++++++++++ .../main/res/drawable-hdpi/ic_launcher.png | Bin 0 -> 4683 bytes .../main/res/drawable-mdpi/ic_launcher.png | Bin 0 -> 2859 bytes .../main/res/drawable-xhdpi/ic_launcher.png | Bin 0 -> 6696 bytes .../main/res/drawable-xxhdpi/ic_launcher.png | Bin 0 -> 10594 bytes .../src/main/res/layout/activity_main.xml | 36 +++ .../src/main/res/values/strings.xml | 8 + connectionclass/.gitignore | 1 + connectionclass/build.gradle | 30 +++ connectionclass/gradle.properties | 3 + connectionclass/src/main/AndroidManifest.xml | 5 + .../connectionclass/ByteArrayScanner.java | 159 ++++++++++++ .../ConnectionClassManager.java | 210 +++++++++++++++ .../connectionclass/ConnectionQuality.java | 43 ++++ .../DeviceBandwidthSampler.java | 135 ++++++++++ .../ExponentialGeometricAverage.java | 60 +++++ .../connectionclass/LineBufferReader.java | 90 +++++++ .../network/connectionclass/QTagParser.java | 149 +++++++++++ .../connectionclass/ConnectionClassTest.java | 172 +++++++++++++ .../connectionclass/invalidrxbytes.txt | 2 + .../connectionclass/sampleqtaguidstats.txt | 241 ++++++++++++++++++ .../connectionclass/strangelytokenedfile.txt | 5 + gradle.properties | 2 + gradle/wrapper/gradle-wrapper.jar | Bin 0 -> 49896 bytes gradle/wrapper/gradle-wrapper.properties | 6 + gradlew | 164 ++++++++++++ gradlew.bat | 90 +++++++ release.gradle | 110 ++++++++ settings.gradle | 2 + 39 files changed, 2107 insertions(+) create mode 100644 .gitignore create mode 100644 CHANGELOG.md create mode 100644 CONTRIBUTING.md create mode 100644 LICENSE create mode 100644 PATENTS create mode 100644 README.md create mode 100644 build.gradle create mode 100644 connectionclass-sample/.gitignore create mode 100644 connectionclass-sample/build.gradle create mode 100644 connectionclass-sample/src/main/AndroidManifest.xml create mode 100644 connectionclass-sample/src/main/java/com/facebook/network/connectionclass/sample/MainActivity.java create mode 100755 connectionclass-sample/src/main/res/drawable-hdpi/ic_launcher.png create mode 100755 connectionclass-sample/src/main/res/drawable-mdpi/ic_launcher.png create mode 100755 connectionclass-sample/src/main/res/drawable-xhdpi/ic_launcher.png create mode 100755 connectionclass-sample/src/main/res/drawable-xxhdpi/ic_launcher.png create mode 100644 connectionclass-sample/src/main/res/layout/activity_main.xml create mode 100644 connectionclass-sample/src/main/res/values/strings.xml create mode 100644 connectionclass/.gitignore create mode 100644 connectionclass/build.gradle create mode 100644 connectionclass/gradle.properties create mode 100644 connectionclass/src/main/AndroidManifest.xml create mode 100644 connectionclass/src/main/java/com/facebook/network/connectionclass/ByteArrayScanner.java create mode 100644 connectionclass/src/main/java/com/facebook/network/connectionclass/ConnectionClassManager.java create mode 100644 connectionclass/src/main/java/com/facebook/network/connectionclass/ConnectionQuality.java create mode 100644 connectionclass/src/main/java/com/facebook/network/connectionclass/DeviceBandwidthSampler.java create mode 100644 connectionclass/src/main/java/com/facebook/network/connectionclass/ExponentialGeometricAverage.java create mode 100644 connectionclass/src/main/java/com/facebook/network/connectionclass/LineBufferReader.java create mode 100644 connectionclass/src/main/java/com/facebook/network/connectionclass/QTagParser.java create mode 100644 connectionclass/src/test/java/com/facebook/network/connectionclass/ConnectionClassTest.java create mode 100644 connectionclass/src/test/java/com/facebook/network/connectionclass/invalidrxbytes.txt create mode 100644 connectionclass/src/test/java/com/facebook/network/connectionclass/sampleqtaguidstats.txt create mode 100644 connectionclass/src/test/java/com/facebook/network/connectionclass/strangelytokenedfile.txt create mode 100644 gradle.properties create mode 100644 gradle/wrapper/gradle-wrapper.jar create mode 100644 gradle/wrapper/gradle-wrapper.properties create mode 100755 gradlew create mode 100644 gradlew.bat create mode 100644 release.gradle create mode 100644 settings.gradle diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..2816b58 --- /dev/null +++ b/.gitignore @@ -0,0 +1,6 @@ +.gradle +/local.properties +/.idea +*.iml +.DS_Store +/build diff --git a/CHANGELOG.md b/CHANGELOG.md new file mode 100644 index 0000000..6467668 --- /dev/null +++ b/CHANGELOG.md @@ -0,0 +1,8 @@ +Change Log +========== + +## Version 1.0.0 + +_2015-03-25_ + + * Initial release. \ No newline at end of file diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md new file mode 100644 index 0000000..57f3d49 --- /dev/null +++ b/CONTRIBUTING.md @@ -0,0 +1,44 @@ +# Contributing to Network Connection Class +We want to make contributing to this project as easy and transparent as +possible. + +## Our Development Process +We work directly in the github project and provide versioned releases +appropriate for major milestones and minor bug fixes or improvements. GitHub +is used directly for issues and pull requests and the developers actively +respond to requests. + +## Pull Requests +We actively welcome your pull requests. +1. Fork the repo and create your branch from `master`. +2. If you've added code that should be tested, add tests +3. If you've changed APIs, update the documentation. +4. Ensure the test suite passes. +5. Make sure your code lints. +6. If you haven't already, complete the Contributor License Agreement ("CLA"). + +## Contributor License Agreement ("CLA") +In order to accept your pull request, we need you to submit a CLA. You only need +to do this once to work on any of Facebook's open source projects. + +Complete your CLA here: + +## Issues +We use GitHub issues to track public bugs. Please ensure your description is +clear and has sufficient instructions to be able to reproduce the issue. + +Facebook has a [bounty program](https://www.facebook.com/whitehat/) for the safe +disclosure of security bugs. In those cases, please go through the process +outlined on that page and do not file a public issue. + +## Coding Style +* 2 spaces for indentation rather than tabs +* Line wrapping indents 4 spaces +* 100 character line length +* One parameter per line when line wrapping is required +* Use the `m` member variable prefix for private fields +* Opening braces to appear on the same line as code + +## License +By contributing to Network Connection Class, you agree that your contributions will be licensed +under its BSD license. \ No newline at end of file diff --git a/LICENSE b/LICENSE new file mode 100644 index 0000000..6bd6bca --- /dev/null +++ b/LICENSE @@ -0,0 +1,30 @@ +BSD License + +For Network Connection Class software + +Copyright (c) 2015, Facebook, Inc. All rights reserved. + +Redistribution and use in source and binary forms, with or without modification, +are permitted provided that the following conditions are met: + + * Redistributions of source code must retain the above copyright notice, this + list of conditions and the following disclaimer. + + * Redistributions in binary form must reproduce the above copyright notice, + this list of conditions and the following disclaimer in the documentation + and/or other materials provided with the distribution. + + * Neither the name Facebook nor the names of its contributors may be used to + endorse or promote products derived from this software without specific + prior written permission. + +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND +ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED +WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE +DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR +ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES +(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; +LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON +ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS +SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. \ No newline at end of file diff --git a/PATENTS b/PATENTS new file mode 100644 index 0000000..030c5f8 --- /dev/null +++ b/PATENTS @@ -0,0 +1,24 @@ +Additional Grant of Patent Rights + +"Software" means the Network Connection Class software distributed by Facebook, +Inc. + +Facebook hereby grants you a perpetual, worldwide, royalty-free, non-exclusive, +irrevocable (subject to the termination provision below) license under any +rights in any patent claims owned by Facebook, to make, have made, use, sell, +offer to sell, import, and otherwise transfer the Software. For avoidance of +doubt, no license is granted under Facebook’s rights in any patent claims that +are infringed by (i) modifications to the Software made by you or a third party, +or (ii) the Software in combination with any software or other technology +provided by you or a third party. + +The license granted hereunder will terminate, automatically and without notice, +for anyone that makes any claim (including by filing any lawsuit, assertion or +other action) alleging (a) direct, indirect, or contributory infringement or +inducement to infringe any patent: (i) by Facebook or any of its subsidiaries or +affiliates, whether or not such claim is related to the Software, (ii) by any +party if such claim arises in whole or in part from any software, product or +service of Facebook or any of its subsidiaries or affiliates, whether or not +such claim is related to the Software, or (iii) by any party relating to the +Software; or (b) that any right in any patent claim of Facebook is invalid or +unenforceable. \ No newline at end of file diff --git a/README.md b/README.md new file mode 100644 index 0000000..36b85f9 --- /dev/null +++ b/README.md @@ -0,0 +1,76 @@ +# Network Connection Class + +Network Connection Class is an Android library that allows you to figure out +the quality of the current user's internet connection. The connection gets +classified into several "Connection Classes" that make it easy to develop +against. The library does this by listening to the existing internet traffic +done by your app and notifying you when the user's connection quality changes. +Developers can then use this Connection Class information and adjust the application's +behaviour (request lower quality images or video, throttle type-ahead, etc). + +## Integration + +### Download +Download [the latest JARs](https://github.com/facebook/network-connection-class/releases/latest) or grab via Gradle: +```groovy +compile 'com.facebook.network.connectionclass:connectionclass:1.0.0' +``` +or Maven: +```xml + + com.facebook.network.connectionclass + connectionclass + 1.0.0 + +``` + +### Calculate Connection Class +Connection Class provides an interface for classes to add themselves as +listeners for when the network's connection quality changes. In the subscriber +class, implement `ConnectionClassStateChangeListener`: + +```java +public interface ConnectionClassStateChangeListener { + public void onBandwidthStateChange(ConnectionQuality bandwidthState); +} +``` + +and subscribe with the listener: + +```java +ConnectionClassManager.getInstance().register(mListener); +``` + +Alternatively, you can manually query for the connection quality bucket with +`getCurrentBandwidthQuality()`. + +```java +ConnectionQuality cq = ConnectionClassManager.getInstance().getCurrentBandwidthQuality(); +``` + +The main way to provide the ConnectionClassManager data is to use the DownloadBandwidthSampler. +The DownloadBandwidthSampler samples the device's underlying network stats when you tell it +you're performing some sort of network activity (downloading photos, playing a video, etc). + +```java +// Override ConnectionClassStateChangeListener +ConnectionClassManager.getInstance().register(mListener); +DownloadBandwidthSampler.getInstance().startSampling(); +// Do some downloading tasks +DownloadBandwidthSampler.getInstance().stopSampling(); +``` + +If the application is aware of the bandwidth downloaded in a certain time frame, +data can be added to the moving average using: + +```java +ConnectionClassManager.addBandwidth(bandwidth, time); +``` + +See the `connectionclass-sample` project for more details. + +## Improve Connection Class! +See the CONTRIBUTING.md file for how to help out. + +## License +Connection Class is BSD-licensed. We also provide an additional patent grant. diff --git a/build.gradle b/build.gradle new file mode 100644 index 0000000..1d37845 --- /dev/null +++ b/build.gradle @@ -0,0 +1,14 @@ +buildscript { + repositories { + jcenter() + } + dependencies { + classpath 'com.android.tools.build:gradle:1.0.0' + classpath 'com.github.jcandksolutions.gradle:android-unit-test:2.1.1' + } +} +allprojects { + repositories { + jcenter() + } +} diff --git a/connectionclass-sample/.gitignore b/connectionclass-sample/.gitignore new file mode 100644 index 0000000..796b96d --- /dev/null +++ b/connectionclass-sample/.gitignore @@ -0,0 +1 @@ +/build diff --git a/connectionclass-sample/build.gradle b/connectionclass-sample/build.gradle new file mode 100644 index 0000000..d274c23 --- /dev/null +++ b/connectionclass-sample/build.gradle @@ -0,0 +1,22 @@ +apply plugin: 'com.android.application' + +repositories { + jcenter() +} + +android { + compileSdkVersion 21 + buildToolsVersion "21.1.2" + + defaultConfig { + applicationId "com.facebook.network.connectionclass.sample" + minSdkVersion 9 + targetSdkVersion 21 + versionCode 1 + versionName "1.0" + } +} + +dependencies { + compile project (":connectionclass") +} diff --git a/connectionclass-sample/src/main/AndroidManifest.xml b/connectionclass-sample/src/main/AndroidManifest.xml new file mode 100644 index 0000000..21648b7 --- /dev/null +++ b/connectionclass-sample/src/main/AndroidManifest.xml @@ -0,0 +1,22 @@ + + + + + + + + + + + + + + + + diff --git a/connectionclass-sample/src/main/java/com/facebook/network/connectionclass/sample/MainActivity.java b/connectionclass-sample/src/main/java/com/facebook/network/connectionclass/sample/MainActivity.java new file mode 100644 index 0000000..caa09f5 --- /dev/null +++ b/connectionclass-sample/src/main/java/com/facebook/network/connectionclass/sample/MainActivity.java @@ -0,0 +1,137 @@ +/* + * This file provided by Facebook is for non-commercial testing and evaluation + * purposes only. Facebook reserves all rights not expressly granted. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +package com.facebook.network.connectionclass.sample; + +import android.app.Activity; +import android.os.AsyncTask; +import android.os.Bundle; + +import android.util.Log; +import android.view.View; +import android.widget.TextView; +import com.facebook.network.connectionclass.*; + +import java.io.IOException; +import java.io.InputStream; +import java.net.URL; + + +public class MainActivity extends Activity { + + private static final String TAG = "ConnectionClass-Sample"; + + private ConnectionClassManager mConnectionClassManager; + private DeviceBandwidthSampler mDeviceBandwidthSampler; + private ConnectionChangedListener mListener; + private TextView mTextView; + private View mRunningBar; + + private String mURL = "http://connectionclass.parseapp.com/m100_hubble_4060.jpg"; + private int mTries = 0; + private ConnectionQuality mConnectionClass = ConnectionQuality.UNKNOWN; + + @Override + protected void onCreate(Bundle savedInstanceState) { + super.onCreate(savedInstanceState); + setContentView(R.layout.activity_main); + mConnectionClassManager = ConnectionClassManager.getInstance(); + mDeviceBandwidthSampler = DeviceBandwidthSampler.getInstance(); + findViewById(R.id.test_btn).setOnClickListener(testButtonClicked); + mTextView = (TextView)findViewById(R.id.connection_class); + mTextView.setText(mConnectionClassManager.getCurrentBandwidthQuality().toString()); + mRunningBar = findViewById(R.id.runningBar); + mRunningBar.setVisibility(View.GONE); + mListener = new ConnectionChangedListener(); + } + + @Override + protected void onPause() { + super.onPause(); + mConnectionClassManager.remove(mListener); + } + + @Override + protected void onResume() { + super.onResume(); + mConnectionClassManager.register(mListener); + } + + /** + * Listener to update the UI upon connectionclass change. + */ + private class ConnectionChangedListener + implements ConnectionClassManager.ConnectionClassStateChangeListener { + + @Override + public void onBandwidthStateChange(ConnectionQuality bandwidthState) { + mConnectionClass = bandwidthState; + runOnUiThread(new Runnable() { + @Override + public void run() { + mTextView.setText(mConnectionClass.toString()); + } + }); + } + } + + private final View.OnClickListener testButtonClicked = new View.OnClickListener() { + @Override + public void onClick(View v) { + new DownloadImage().execute(mURL); + } + }; + + /** + * AsyncTask for handling downloading and making calls to the timer. + */ + private class DownloadImage extends AsyncTask { + + @Override + protected void onPreExecute() { + mDeviceBandwidthSampler.startSampling(); + mRunningBar.setVisibility(View.VISIBLE); + } + + @Override + protected Void doInBackground(String... url) { + String imageURL = url[0]; + try { + // Open a stream to download the image from our URL. + InputStream input = new URL(imageURL).openStream(); + try { + byte[] buffer = new byte[1024]; + + // Do some busy waiting while the stream is open. + while (input.read(buffer) != -1) { + } + } finally { + input.close(); + } + } catch (IOException e) { + Log.e(TAG, "Error while downloading image."); + } + return null; + } + + @Override + protected void onPostExecute(Void v) { + mDeviceBandwidthSampler.stopSampling(); + // Retry for up to 10 times until we find a ConnectionClass. + if (mConnectionClass == ConnectionQuality.UNKNOWN && mTries < 10) { + mTries++; + new DownloadImage().execute(mURL); + } + if (!mDeviceBandwidthSampler.isSampling()) { + mRunningBar.setVisibility(View.GONE); + } + } + } +} diff --git a/connectionclass-sample/src/main/res/drawable-hdpi/ic_launcher.png b/connectionclass-sample/src/main/res/drawable-hdpi/ic_launcher.png new file mode 100755 index 0000000000000000000000000000000000000000..eba84960a32500e8de0d5db80403e817c133a3ec GIT binary patch literal 4683 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
8gG7IZwoXRKrFI* z_im1Zg99yc7$@XHGMDP^J*k4^l%RhD`ZwS+vI!F=yz$>{{tp=7h<+joauxsp002ov JPDHLkV1h#eg`EHZ literal 0 HcmV?d00001 diff --git a/connectionclass-sample/src/main/res/drawable-xhdpi/ic_launcher.png b/connectionclass-sample/src/main/res/drawable-xhdpi/ic_launcher.png new file mode 100755 index 0000000000000000000000000000000000000000..c49fc7b06cb450ea125ae341ac19c7b016880f3e GIT binary patch literal 6696 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 w?uxn<{o$DVAz8G6I29@?O + +