HealthVault Java Library

New Post: How to Create a Certificate

vaibhavb_msft — Mon, 03 Nov 2008 18:24:56 GMT

Please note the command line in for keytool needs to be updated, the default behavior of the tool is to generate a certificate which expires in 90 days. You can use the following to have the certificate valid for 9999 (which starting now might be ~ 2038).

keytool -genkey -keyalg RSA -keysize 1024 -keystore keystore -alias java-wildcat -validity 9999

More details about how HealthVault deals with expiring certs can be found in this post.

New Post: Customize reading of the application config properties

robmay — Fri, 26 Sep 2008 21:33:58 GMT

The only purpose for the ApplicationConfig class is for the ConnectionFactory when it assembles everything necessary for a Connection. You should feel free to create connections however you like and inject values from whatever configuration source desired.

This might be a good item to separate out a little better.

New Post: PPE HealthVaultService URL

vaibhavb_msft — Tue, 16 Sep 2008 20:02:46 GMT

Yes. The Shell URLs for all development platforms (.NET and Non .NET) are the same.

Just an additional pointer:
You read more about the shell redirect interfaces at: http://msdn.microsoft.com/en-us/healthvault/cc265056.aspx and
Action URL at: http://msdn.microsoft.com/en-us/healthvault/bb852205.aspx

Hope this helps.

regards,
Vaibhav

New Post: PPE HealthVaultService URL

saiyedfazal — Tue, 16 Sep 2008 17:44:13 GMT

Hi Vaibhav
Can you also verify the Shell urls for Java.
PPE- https://account.healthvault-ppe.com/redirect.aspx?target=AUTH&targetqs=?appid=$appId
PROD- https://account.healthvault.com/redirect.aspx?target=AUTH&targetqs=?appid=$appId

Thanks

New Post: Customize reading of the application config properties

vaibhavb_msft — Fri, 12 Sep 2008 21:01:34 GMT

hi Fazal -

All the config is encapsulated in ApplicationConfig.java and i think that the only place you might have to modify to switch from Java properties file to JNDI. Rob, please correct me if i'm wrong.

regards,
Vaibhav

New Post: PPE HealthVaultService URL

vaibhavb_msft — Fri, 12 Sep 2008 19:11:56 GMT

hi Fazal -

Yes, you will have to use the full service identified url for Java (/Non-.Net) solution, for both PPE and Produciton: https://platform.healthvault-ppe.com/platform/wildcat.ashx (PPE), https://platform.healthvault.com/platform/wildcat.ashx (PROD).

regards,
Vaibhav

New Post: Customize reading of the application config properties

saiyedfazal — Fri, 12 Sep 2008 19:03:53 GMT

Hi
I am planning to modify the client library to read the application config properties from JNDI instead of plain Java properties file. I have identified com.microsoft.hsg.ApplicationConfig.java to be the only class that would have to be changed. Can you please verify if this is correct?

Thanks
Fazal

New Post: PPE HealthVaultService URL

vaibhavb_msft — Fri, 12 Sep 2008 17:13:33 GMT

hi Fazal-

What is the context in which you are using the PPE service url for Java library configuration or some other methods calls.

regards,
Vaibhav

New Post: PPE HealthVaultService URL

saiyedfazal — Fri, 12 Sep 2008 14:13:25 GMT

Hello
MSDN documentation has PPE service url as https://platform.healthvault-ppe.com/platform. But when I used that url for PPE, app received exception. I used https://platform.healthvault-ppe.com/platform/wildcat.ashx and it worked. Please confirm which url should be used.

Thanks
Fazal

New Post: Support for JDK 1.4.2

robmay — Thu, 21 Aug 2008 22:07:47 GMT

When the response contains a status code != 0, the integer code is set on the Response object and an HVRequestException is thrown containing a StatusCode enum. The enum is populated with the codes known at development time, and any new codes are mapped to UNKNOWN at runtime This probably needs cleaning up and unifying regardless of JDK version.

--Rob

New Post: Support for JDK 1.4.2

saiyedfazal — Thu, 21 Aug 2008 21:48:53 GMT

I am not sure about 3 - "Removing the enum for response code. This may have been a mistake anyways since in order to make it forwards compatible, we really need the integer response code. "
Aren't the response codes already integers - 7, 8, 11.....etc?

Fazal

New Post: Offline access

vaibhavb — Thu, 21 Aug 2008 21:01:18 GMT

hi Jun -

What is the appid you are using? We suspect that it might not have correct offline permissions.

regards,
Vaibhav

New Post: Offline access

vaibhavb — Thu, 21 Aug 2008 20:26:38 GMT

Rob -

Moving the conversation from HealthVault forum:http://forums.microsoft.com/msdn/ShowPost.aspx?PostID=3776690&SiteID=1&mode=1 to here.

In addition to above Jun has posted:
"

I am using Java library. I am be able to do "GetAuthorizedConnectRequests" and "CreateConnectRequest". I have tried to do "GetThings", but it failed too. Below is the xml of the response.

<?xml version="1.0" encoding="utf-8"?>
<response>
<status>
  <code>11</code>
  <error>
   <message>Access is denied.</message>
  </error>
</status>
</response>

Thanks
Jun
"

regards,
Vaibhav

New Post: Go Live Guide for Java SDK

robmay — Thu, 21 Aug 2008 19:33:35 GMT

The .cer files are DER encoded X.509 certificates for the public key. .pfx files contain both the private key and the public key. The public key and needs to get into HealthVault's application repository. The private key goes into the keystore. The easiest way to get a private key into the keystore is to generate it there in the first place. Then export the public key as the .cer file. Generating a private key elsewhere and importing it into the keystore requires writing some custom code--not difficult, just not existing. None of the keytool's commands support importing/exporting the private keys.

So as vaibhav recommended, use the application manager to create your app in HealthVault initially. The application manager wants a .pfx file because it places the private key into windows local key manager and registers your public key with HealthVault. The first step is unnecessary for java applications but the tools show their origins. Once your application is created in HealthVault, replace you public key stored with HealthVault with one generated with the keytool. Protect the keystore and your private key, as it provides your access to HealthVault.

New Post: Offline access

robmay — Thu, 21 Aug 2008 18:30:26 GMT

Jun,

Your request looks perfect. Can you ensure that your application auth rules grant offline access to weight things? There are two separate rule configurations, one for online (when the user is logged in and you have a user-auth-token) and one for offline (when the user is not logged in and you do not have a user-auth-token).

Also, if you changed your application auth rules, the user will have to reauthorize your application before you can make any calls for that user and their record.

If you post your application-id we might be able to check for you.

I'll try and work up an offline sample and post it in the next couple of days. I'll also be posting an optional library to parse all the requests/responses/types. Hopefully things will only get easier as we go forward.

--Rob

New Post: Offline access

cutsethuang — Wed, 20 Aug 2008 20:44:44 GMT

I tried to use sdk to send out a new weight measurement record by using "PutThings" methode. The request sent out xml like below, but I get a "Access is Denied" response. I have granted all permission on weight measurement in configuration center.

Anything I missed in Requset?

Thanks for any advice you can provide.

<wc-request:request xmlns:wc-request="urn:com.microsoft.wc.request">
    <auth>
        <hmac-data algName="HMACSHA1">
            tTF4YKXJQVRTjwY683x9muupjzo=
        </hmac-data>
    </auth>
    <header>
        <method>PutThings</method>
        <method-version>1</method-version>
        <record-id>d2df9249-f026-4467-b29d-79990845a6c2</record-id>
        <auth-session>
            <auth-token>
                ASAAAE57vlXwS8VDupO6/FSWlMZLmdMdQucEzxQXYhr9+4fNXUDftpv2gI/MYj6QjIt1ga2JfTMP77OAtV9fOuwSegITK7R2fpLt/8WY1C7RgY/8JSFFd0BJ5su5MR+tVcozRjN4wLF2XlSgK0vABECUlYdpqFRWNv/iYPWrcFpZpwEUZzHqdi7YD1cbUb7S+DCGm3V2Q0n4IopRYoadp5Vkj6oswmuh
            </auth-token>
            <offline-person-info>
                <offline-person-id>
                    b8d3cdfa-ca1c-4eaa-aa20-ef0d71a1f7da
                </offline-person-id>
            </offline-person-info>
        </auth-session>
        <language>en</language>
        <country>US</country>
        <msg-time>2008-08-19T17:08:00.719-04:00</msg-time>
        <msg-ttl>180000</msg-ttl>
        <version>0.0.0.1</version>
        <info-hash>
            <hash-data algName="SHA1">
                BLSLU/dw6ShY/UckpJJTTDEDumE=
            </hash-data>
        </info-hash>
    </header>
    <info>
        <thing>
            <type-id>3d34d87e-7fc1-4153-800f-f56592cb0d17</type-id>
            <data-xml>
                <weight>
                    <when>
                        <date>
                            <y>2008</y>
                            <m>8</m>
                            <d>19</d>
                        </date>
                        <time>
                            <h>17</h>
                            <m>8</m>
                            <s>0</s>
                        </time>
                    </when>
                    <value>
                        <kg>99.99</kg>
                        <display units="lb" units-code="lb">
                            99.99
                        </display>
                    </value>
                </weight>
                <common />
            </data-xml>
        </thing>
    </info>
</wc-request:request>

New Post: Go Live Guide for Java SDK

vaibhavb — Wed, 20 Aug 2008 18:12:00 GMT

hi Ryan -

You can add the .cer file to your application from application configuration center if it already exists from the "Public Key" tab. Please note that in order for you to upload the application to our server (via applicaiton manager) you will have to create a PFX cert using the create certificate button and then right click on that cert and upload it. Once you do this you can actually associate the public key (.cer file) of your java private key using the "Public Key" tab of application configuration center.

Essentially you first create an app with a generated cert (pfx file) and then add the .cer file to this application.

Hope this helps.

regards,
Vaibhav

New Post: Support for JDK 1.4.2

vaibhavb — Wed, 20 Aug 2008 17:10:10 GMT

Just to add more information and close the loop here.

The biggest hurdle supporting JDK 1.4.2 is in the HTTP connection library delivered with JDK 1.4 and below. It isn't very robust and doesn't support timeouts. Most companies making web requests in Java use a library either from their J2EE vendor, Apache or elsewhere. Sun rewrote this layer in Java 1.5 and fixed some of the major issues. <o:p></o:p>

At first glance back porting the library involves:

Creating an implementation of the Transport interface with an HTTP client based on something else (Apache's HttpClient perhaps?). This layer is interface based so it shouldn't be difficult to switch between implementations.
Removing all generic collection classes and use their unchecked counterparts.
Removing the enum for response code. This may have been a mistake anyways since in order to make it forwards compatible, we really need the integer response code.
Reworking the XPath parsing of the response code since XPath is not part of v1.4.
Changing all StringBuilders to StringBuffers

New Post: Go Live Guide for Java SDK

ryanTJ — Wed, 20 Aug 2008 16:42:40 GMT

I just want to know how to get my Java SDK using application setup on the production environment. There seems to be conflicting documents and mostly centered around the .Net SDK which one document tells me to use the application manager which wants the cert in PFX format not the format that keytool exports. If that is even the correct path for the Java version I do not know.

New Post: Go Live Guide for Java SDK

ryanTJ — Wed, 20 Aug 2008 16:27:32 GMT

Thanks but I have read the other forums and the keytool information and the keytool generates a .cer file which I am not able to import into the application manager.