Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/hansemannn/titanium-firebase-database
Use the Firebase Realtime Database SDK in Axway Titanium 🚀
https://github.com/hansemannn/titanium-firebase-database
firebase firebase-database javascript native titanium titanium-firebase
Last synced: about 1 month ago
JSON representation
Use the Firebase Realtime Database SDK in Axway Titanium 🚀
- Host: GitHub
- URL: https://github.com/hansemannn/titanium-firebase-database
- Owner: hansemannn
- License: other
- Created: 2018-01-08T12:11:59.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2024-04-07T15:49:53.000Z (9 months ago)
- Last Synced: 2024-05-01T20:23:42.052Z (8 months ago)
- Topics: firebase, firebase-database, javascript, native, titanium, titanium-firebase
- Language: Objective-C
- Homepage:
- Size: 27.4 MB
- Stars: 7
- Watchers: 6
- Forks: 5
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# Firebase Database - Titanium Module
Use the native Firebase SDK in Axway Titanium. This repository is part of the [Titanium Firebase](https://github.com/hansemannn/titanium-firebase) project.
## Supporting this effort
The whole Firebase support in Titanium is developed and maintained by the community (`@hansemannn` and `@m1ga`). To keep
this project maintained and be able to use the latest Firebase SDK's, please see the "Sponsor" button of this repository,
thank you!
## Requirements
- [x] The [Firebase Core](https://github.com/hansemannn/titanium-firebase-core) module
- [x] Titanium SDK 6.3.0+
## ToDo's
- [ ] Property format nested lists in this Readme
## API's
### `FirebaseDatabase`
#### Methods
- `getReference(arguments)` -> `FirebaseDatabaseReference`
 \- `identifier` (String), `path` (String) **OR** `url` (String)
 \- `observableEvents` ([`DATA_EVENT_TYPE_*`])
#### Properties
- `firebaseServerTimestamp`
### `FirebaseDatabaseReference`
#### Methods
- `child(arguments)` -> `FirebaseDatabaseReference`
- `identifier` (String), `path` (String) **OR** `url` (String)
 \- `observableEvents` ([`DATA_EVENT_TYPE_*`])
- `childByAutoId(arguments)` -> `FirebaseDatabaseReference`
- `identifier` (String), `path` (String) **OR** `url` (String)
 \- `observableEvents` ([`DATA_EVENT_TYPE_*`])
- `root(arguments)` -> `FirebaseDatabaseReference`
 \- `observableEvents` ([`DATA_EVENT_TYPE_*`])
- `parent(arguments)` -> `FirebaseDatabaseReference`
- `observableEvents` ([`DATA_EVENT_TYPE_*`])
- `setValue(value, callback)`
- `value` (Any)
 \- `callback` (optional, Function)
- `removeValue(callback)`
 \- `callback` (optional, Function)
- `updateChildValues(childValues, callback)`
 \- `childValues` (Dictionary)
 \- `callback` (optional, Function)
- `setPriority(priority, callback)`
 \- `priority` (Any)
 \- `callback` (optional, Function)
- `goOnline()`
- `goOffline()`
- `keepSynced(synced)`
 \- `synced` (Boolean)
#### Properties
- `key` (String)
- `url` (String)
#### Constants
- `DATA_EVENT_TYPE_VALUE`
- `DATA_EVENT_TYPE_CHILD_ADDED`
- `DATA_EVENT_TYPE_CHILD_CHANGED`
- `DATA_EVENT_TYPE_CHILD_MOVED`
- `DATA_EVENT_TYPE_CHILD_REMOVED`
## Events
Important note: Events are added and removed generically. They are only fired if you observe them via
the `observableEvents` parameter.
- `value` (via `DATA_EVENT_TYPE_VALUE`)
- `add` (via `DATA_EVENT_TYPE_CHILD_ADDED`)
- `change` (via `DATA_EVENT_TYPE_CHILD_CHANGED`)
- `move` (via `DATA_EVENT_TYPE_CHILD_MOVED`)
- `remove` (via `DATA_EVENT_TYPE_CHILD_REMOVED`)
## Example
```js
const win = Ti.UI.createWindow({layout:'vertical', title:'Firebase Database'});
const btn1 = Ti.UI.createButton({title:'add random item'});
const btn2 = Ti.UI.createButton({title:'delete last item'});
win.add([btn1, btn2])
// Require the Firebase Database module
const FirebaseDatabase = require('firebase.database');
var randomReference = null;
btn1.addEventListener('click', function(){
// Inserting values in firebase database
randomReference = FirebaseDatabase.getReference().childByAutoId({
path: 'user'
});
randomReference.setValue({
username: 'username',
email: '[email protected]',
password: 'ABCXYZ',
timestamp: FirebaseDatabase.firebaseServerTimestamp
}, function(e) {
Ti.API.info('Value written, snapshot: ' + JSON.stringify(e, null, 4));
});
})
btn2.addEventListener('click', function(){
if (randomReference) {
// remove last random item
randomReference.removeValue();
randomReference = null;
}
});
// insert fixed item
var fdRef = FirebaseDatabase.getReference().child({
path: 'user',
identifier: 'user1'
});
fdRef.setValue({
username: 'fixed username',
email: '[email protected]',
password: 'ABCXYZ_fixed',
timestamp: FirebaseDatabase.firebaseServerTimestamp
}, function(e) {
Ti.API.info('Value written, snapshot: ' + JSON.stringify(e, null, 4));
});
// Fetching values from Firebase database
var userRef = FirebaseDatabase.getReference({
path: 'user',
observableEvents: [FirebaseDatabase.DATA_EVENT_TYPE_CHILD_ADDED, FirebaseDatabase.DATA_EVENT_TYPE_VALUE]
});
userRef.addEventListener('value', function(e) {
Ti.API.info('DATA_EVENT_TYPE_VALUE, snapshot: ' + JSON.stringify(e));
});
userRef.addEventListener('add', function(e) {
Ti.API.info('DATA_EVENT_TYPE_CHILD_ADDED, snapshot: ' + JSON.stringify(e));
});
userRef.addEventListener('remove', function(e) {
Ti.API.info('removed value' + JSON.stringify(e));
});
win.open();
```
- [Example](https://github.com/RavindraChherke/titanium-firebase-database/blob/new_functions/example/app.js)
## Build
```js
cd ios
appc run -p ios --build-only
```
## Legal
This module is Copyright (c) 2018-present by Hans Knöchel, Inc. All Rights Reserved.