Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/belgattitude/soluble-japha-pjb62-compat
soluble-japha pjb62 compatibility layer
https://github.com/belgattitude/soluble-japha-pjb62-compat
client compatibility php-java-bridge
Last synced: 24 days ago
JSON representation
soluble-japha pjb62 compatibility layer
- Host: GitHub
- URL: https://github.com/belgattitude/soluble-japha-pjb62-compat
- Owner: belgattitude
- License: mit
- Created: 2016-06-11T11:49:36.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2017-03-01T13:52:27.000Z (over 7 years ago)
- Last Synced: 2024-08-05T18:31:54.220Z (3 months ago)
- Topics: client, compatibility, php-java-bridge
- Language: PHP
- Size: 29.3 KB
- Stars: 0
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# soluble-japha-pjb62-compat
[](https://packagist.org/packages/soluble/japha-pjb62-compat)
[](https://travis-ci.org/belgattitude/soluble-japha-pjb62-compat)
[](https://scrutinizer-ci.com/g/belgattitude/soluble-japha-pjb62-compat/?branch=master)
[](https://scrutinizer-ci.com/g/belgattitude/soluble-japha-pjb62-compat/?branch=master)
[](https://packagist.org/packages/soluble/japha-pjb62-compat)
[](https://packagist.org/packages/soluble/japha-pjb62-compat)
[](https://packagist.org/packages/soluble/japha-pjb62-compat)
## Introduction
*** Work in progress ***
*Historically the [PHP/Java bridge](http://php-java-bridge.sourceforge.net/pjb/) client didn't
support namespaces.*
*Install this package if you have existing code relying on legacy php-java-bridge and
don't want to refactor to the newer implementation provided by [soluble/japha](https://github.com/belgattitude/soluble-japha).*
## Features
- Make [soluble-japha](https://github.com/belgattitude/soluble-japha) compatible with the procedural phpjavabridge legacy api
## Requirements
- PHP 5.5+, 7.0 or HHVM >= 3.2.
- The [PHPJavaBridge server running](./doc/install_server.md)
## Installation
1. PHP installation *(client)*
Through [composer](http://getcomposer.org/).
```console
$ composer require "soluble/japha-pjb62-compat"
```
Most modern frameworks will include Composer out of the box, but ensure the following file is included:
```php
'Pjb62',
'servlet_address' => 'localhost:8089/servlet.phpjavabridge'
]);
```
This replace the `include('xxx/Java.inc)` used in previous versions.
### Basic Java usage
With legacy mode enabled you can use the java* function directly
```php
'Pjb62',
'servlet_address' => 'localhost:8083/servlet.phpjavabridge'
]);
$bigint = new Java("java.math.BigInteger", 1);
$system = java_class('java.lang.System);
java_instanceof($bigint, 'java.math.BigInteger'); // -> true
java_inspect($bigint);
java_values($bigint);
//java_invoke();
```
### API
### Refactor constants
|Constant | Example |
|----------------------------|-------------------------------------------|
| `JAVA_HOSTS` | `define("JAVA_HOSTS", "127.0.0.1:8787")` |
| `JAVA_SERVLET` | `define("JAVA_SERVLET", "/MyWebApp/servlet.phpjavabridge")` |
| `JAVA_PREFER_VALUES` | `define("JAVA_PREFER_VALUES", 1)` |
| `JAVA_LOG_LEVEL` | `define("JAVA_LOG_LEVEL", null)` |
| `JAVA_SEND_SIZE` | `define("JAVA_SEND_SIZE", 8192)` |
| `JAVA_RECV_SIZE` | `define("JAVA_RECV_SIZE", 8192)` |
| `JAVA_DISABLE_AUTOLOAD` | Not applicable anymore - PSR4 ;) |
### Initialization
| Old way | New way |
|----------------------------|-------------------------------------------|
|`include(... /Java.inc)` | `$ba = new Bridge\Adapter($option);` |
### API
The following table maps old and new recommended API.
|Legacy | `Bridge\Adapter` ($ba) |
|-------------------------------------------------|-------------------------------------------|
|`new Java($class, $args=null)` : `Java` | `$ba->java($class, $args=null)` : `Interfaces\JavaObject` |
|`java_class($class)` : `JavaClass` | `$ba->javaClass($class)` `Interfaces\JavaClass` |
|`java_instanceof($object, $class)` : `boolean` | `$ba->isInstanceOf($object, $class)` : `boolean` |
(under review, soon to be implemented)
|Legacy | `Bridge\Adapter` ($ba) |
|--------------------------------------------|------------------------------------------|
|`java_values($object)` : `mixed` | `$ba->getValues($object)` : `mixed` |
|`java_invoke($object, $method, $args=null)` : `mixed|null` | `$ba->invokeMethod($object, $method, $args=null) : `string\null` |
|`java_inspect($object)` : `string` | `$ba->debug()->inspect($object)` : `string` |
|`getLastException` : `Exception` | `$ba->debug()->getLastException()` : `Exception` |
|`clearLastException` | `$ba->debug()->clearLastException()` |
function java_is_null($value)
function java_is_true($value)
function java_is_false($value)
## Refactoring guidelines
Keep a step by step approach... you can use both API at the same time.
1. Try to change intialization sequence
## Coding standards
* [PSR 4 Autoloader](https://github.com/php-fig/fig-standards/blob/master/accepted/PSR-4-autoloader.md)
* [PSR 2 Coding Style Guide](https://github.com/php-fig/fig-standards/blob/master/accepted/PSR-2-coding-style-guide.md)
* [PSR 1 Coding Standards](https://github.com/php-fig/fig-standards/blob/master/accepted/PSR-1-basic-coding-standard.md)
* [PSR 0 Autoloading standards](https://github.com/php-fig/fig-standards/blob/master/accepted/PSR-0.md)