https://github.com/brodycj/aq-query-test-android

Asynchronous Javascript query from web worker in WebView working for Android
https://github.com/brodycj/aq-query-test-android

Last synced: about 1 month ago
JSON representation

Asynchronous Javascript query from web worker in WebView working for Android

• Host: GitHub
• URL: https://github.com/brodycj/aq-query-test-android
• Owner: brodycj
• Created: 2015-11-03T11:31:45.000Z (about 9 years ago)
• Default Branch: master
• Last Pushed: 2015-11-24T18:01:52.000Z (about 9 years ago)
• Last Synced: 2024-07-31T00:17:05.930Z (5 months ago)
• Language: Java
• Size: 13.7 KB
• Stars: 1
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# AQTest: asynchronous query from web worker to native Android code using XHR

Author: Christopher J. Brody

License: UNLICENSE (public domain)

I can hereby testify that this project is completely my own work and not subject to agreements with any other parties.

In case of code written under direct guidance from sample code the link is given for reference.

In case I accept contributions from any others I will require CLA with similar statements.

## About

This project demonstrates the following:

- Ability to request native iOS functionality from within a web worker *and return a callback to the web worker*.

- Build a hybrid Javascript-native app without using a framework such as Cordova which requires attribution of use.

The interaction between Javascript and native Java works as follows:

- The Javascript executes a simple XHR POST with a `file:` or custom URI

- The Java sees URL request and triggers the Javascript `aqcallback` function with a string that echos the URI from the XHR request

This project also has an `AQManager` component that keeps and handles the routing for multiple components that implement the `AQHandler` interface.

This project is a starting point for the following ideas (so far):

- Javascript-native interface that can be used from a web worker within Cordova, such as: [@brodybits / cordova-aqs-android](https://github.com/brodybits/cordova-aqs-android) and [@brodybits / cordova-aqs-ios](https://github.com/brodybits/cordova-aqs-ios)

- Provide a sqlite database access layer for Javascript that can be used within multiple Javascript-native bridging frameworks including Cordova, React Native, and NativeScript

- Provide a public-domain Javascript-native access bridge

## Security warning

The Cordova project has been fixing security issues in its external domain whitelist plugin over time, and has also dealt with security issues in its internal bridging mechanism. It is very strongly advised NOT to release an app with a custom-built web view bridging or domain whitelisting mechanism without proper code review and testing.

## Other major limitations

- There is no general message queueing. The idea is currently let each component implement its own queueing mechanism.

## Related project(s)

- [@brodybits / aqsa-query-test-ios](https://github.com/brodybits/aqsa-query-test-ios) - request native iOS functionality from within a web worker

- [@brodybits / cordova-aqs-android](https://github.com/brodybits/cordova-aqs-android) and [@brodybits / cordova-aqs-ios](https://github.com/brodybits/cordova-aqs-ios)

A similar concept described in my [Starting JSONBus: towards a replacement for Cordova/PhoneGap](http://brodyspark.blogspot.com/2012/12/starting-jsonbus-towards-replacement.html) post on an old blog in December 2012.