[vbox-dev] VirtualBox SDK Source Code Availability?

[Klaus Espenlaub]

On 20.09.2011 16:19, David J. Shepard wrote:
> Hello.
>
> I tried to get an answer to this question on the VirtualBox forums and
> eventually was referred to this mailing list. I've been trying to find
> out if the source code to the VirtualBox SDK is available. Specifically,
> I am looking for the source code to vboxjws.jar, which is in the path
> sdk/bindings/webservice/java/jax-ws/ in the 4.1.2 version of the SDK.

Working on it, but didn't have time to wrap things up and backport to 
4.1. In trunk we already have various improvements in this area:
* vboxjws.jar is now an OSGi bundle
* vboxjws-src.jar is provided
* vboxjws-doc.jar contains javadoc generated docs, with API spec

So you have to hope for less hectic times...

> Failing that, I would be happy to have some javadoc, if that is
> available. Failing that, is there some method people who are using the
> SDK are supposed to use to find out the specifics of API arguments, such
> as what to expect they are being used for, or perhaps what methods are
> going to throw VBoxException, etc…? I've been able to find very little
> documentation on the API set itself. The document SDKRef.pdf mentions
> VBoxException one time and literally makes it sound like every method
> can throw it, but doesn't give any indication as to what circumstances
> will cause the exception to be thrown by a given API.

This impression is true. Any method can fail, and failures are 
translated to throwing this exception. So your code must be prepared to 
handle this.

> Please let me know if there is some place I can find the SDK source code
> or any other options that may be helpful.

Honestly the soure of vboxjws.jar is extremely boring - 99.9% of it is 
automatically generated stubs code, which is why we didn't bother making 
it public.

Klaus

>
> Thanks.
> --David
>
>
>
> _______________________________________________
> vbox-dev mailing list
> vbox-dev at virtualbox.org
> http://vbox.innotek.de/mailman/listinfo/vbox-dev