Skip to content

quonn77/onvif

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

15 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Java ONVIF (Open Network Video Interface Forum)

ONVIF is a community to standardize communication between IP-based security products (like cameras).

This project aims to improve https://github.com/milg0/onvif-java-lib.
I've tried to convice its author to use to my code but it seems we have different objectives: my goal is to create a project that focus on the funny part of the development of an ONVIF application, keeping the interaction with the WS as simple as possible and delege that annoying part to Apache CXF in order to not waste the developer time in writing (and MAINTAINING) code that interacts with ONVIF web services.
My wish is to help other developers willing to contribute to an enterprise-level Java library for ONVIF devices.

Fork improvements (quonn77)

  • onvif-ws-client: WS stubs are no more part of the repository, you can simply generate them using the most updated version of the wsdl files. Generated source files are under target/generated-sources standard maven folder.
  • WSSE UsernameToken: Support for username token authentication has been added. You have to properly initiliaze UTPasswordCallback class by providing the username, password pairs using the setAliasPassword method.
  • Multi network card support. In order to avoid problem on a multinetwork environment you can specify which is the name of the network adapter to use (E.g. eth0). You have to provide it using JVM parameter -DnetworkInterface= (default eth0) Apported improvements =============
  • Project mavenization and modularization (separation between Java stubs and application) and
  • WS client generation using Apache CXF maven plugin (declaring the specific Onvif specification of each wsdl)
  • maintainability and extendability of the overall code
  • Separation of Test/examples from other code

Rebuilding WS stubs

If you need to change the list of managed WSDLs (in onvif/onvif-ws-client/src/main/resources/wsdl) and thus you need to regenerate the WS Java stubs using the Apache CXF codegen maven plugin, you need to go through the following steps:

  1. Download Onvif WSDLs to onvif/onvif-ws-client/src/main/resources/wsdl appending the version before the .wsdl suffix. For example, from main dir (onvif) use you can run the following shell commmand:
    wget http://www.onvif.org/onvif/ver10/device/wsdl/devicemgmt.wsdl onvif-ws-client/src/main/resources/wsdl/devicemgmt_2.5.wsdl
  2. Update WSDLLocations constants (if needed) within class de.onvif.utils.WSDLLocations (module onvif-java)
  3. Add required url-rewriting rules (if needed) to onvif/onvif-ws-client/src/main/resources/wsdl/jax-ws-catalog.xml
  4. Delete old Java classes in onvif/onvif-ws-client/src/main/java
  5. Run the class generation command: decomment goal and phase of cxf-codegen-plugin in onvif-ws-client pom.xml and run mvn clean install
  6. To see how to properly add a new ONVIF service to OnvifDevice look into OnvifDevice.init()

TODOS

My next goals are:

  1. Create an active community of enthusiastic developers (the crazier you are, the better)
  2. Write a more comprehensive examples (e.g. subscribe to an event notification, use I/O ports, etc...)
  3. Create consistent Onvif specifications tags (at least for onvif-ws-client). For example: 2.4, 2.5, etc...
  4. Fix WS-Discovery example (with my camera it doesn't work at all)
  5. Write a simple UI to test the device functionalities
  6. Fix offline mode (xml files in local folder)

About

Java ONVIF library

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Java 100.0%