Fix243 245 254 #33
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,137 +1,135 @@ | ||
| #Windows Azure SDK for Java | ||
|
|
||
| This SDK allows you to build Windows Azure applications in Java that allow | ||
| you to take advantage of Azure scalable cloud computing resources: table and blob | ||
| storage, messaging through Service Bus. | ||
|
|
||
| For documentation please see the [Windows Azure Java Developer Center](http://www.windowsazure.com/en-us/develop/java/) | ||
|
|
||
| #Features | ||
| * Blob | ||
| * Create/Read/Update/Delete Blobs | ||
| * Queue | ||
| * Create/Delete Queues | ||
| * Insert/Peek Queue Messages | ||
| * Advanced Queue Operations | ||
| * Service Bus | ||
| * Use either the Queue or Topic/Subscription Model | ||
| * Service Runtime | ||
| * Retrieve information about the state of your Azure Compute instances | ||
| * Table | ||
| * Manage Tables | ||
| * Work with Table Entities (CRUD) | ||
| * Entity Group Transactions (Batch) | ||
|
|
||
| #Getting Started | ||
|
|
||
| ##Download | ||
| ###Option 1: Via Git | ||
|
|
||
| To get the source code of the SDK via git just type: | ||
|
|
||
| git clone git://github.com/WindowsAzure/azure-sdk-for-java.git | ||
| cd ./azure-sdk-for-java | ||
| mvn compile | ||
|
|
||
| ###Option 2: Via Maven | ||
|
|
||
| To get the binaries of this library as distributed by Microsoft, ready for use | ||
| within your project you can also have them installed by the Java package manager Maven. | ||
|
|
||
| <dependency> | ||
| <groupId>com.microsoft.windowsazure</groupId> | ||
| <artifactId>microsoft-windowsazure-api</artifactId> | ||
| <version>0.1.0</version> | ||
| </dependency> | ||
|
|
||
| ##Minimum Requirements | ||
|
|
||
| * Java 1.6 | ||
| * (Optional) Maven | ||
|
|
||
|
|
||
| ##Usage | ||
|
|
||
| To use this SDK to call Windows Azure services, you need to first create an | ||
| account. To host your Java code in Windows Azure, you additionally need to download | ||
| the full Windows Azure SDK for Java - which includes packaging, emulation, and | ||
| deployment tools. | ||
|
|
||
| ##Code Samples | ||
|
|
||
| The following is a quick example on how to set up a Azure blob using the API | ||
| and uploading a file to it. For additional information on using the client libraries to access Azure services see the How To guides listed [here](http://www.windowsazure.com/en-us/develop/java/). | ||
|
|
||
| import com.microsoft.windowsazure.services.core.storage.*; | ||
| import com.microsoft.windowsazure.services.blob.client.*; | ||
|
|
||
| public class BlobSample { | ||
|
|
||
| public static final String storageConnectionString = | ||
| "DefaultEndpointsProtocol=http;" + | ||
| "AccountName=your_account_name;" + | ||
| "AccountKey= your_account_name"; | ||
|
|
||
| public static void main(String[] args) | ||
| { | ||
| try | ||
| { | ||
| CloudStorageAccount account; | ||
| CloudBlobClient serviceClient; | ||
| CloudBlobContainer container; | ||
| CloudBlockBlob blob; | ||
|
|
||
| account = CloudStorageAccount.parse(storageConnectionString); | ||
| serviceClient = account.createCloudBlobClient(); | ||
| // Container name must be lower case. | ||
| container = serviceClient.getContainerReference("blobsample"); | ||
| container.createIfNotExist(); | ||
|
|
||
| // Set anonymous access on the container. | ||
| BlobContainerPermissions containerPermissions; | ||
| containerPermissions = new BlobContainerPermissions(); | ||
|
|
||
| // Upload an image file. | ||
| blob = container.getBlockBlobReference("image1.jpg"); | ||
| File fileReference = new File ("c:\\myimages\\image1.jpg"); | ||
| blob.upload(new FileInputStream(fileReference), fileReference.length()); | ||
| } | ||
| catch (FileNotFoundException fileNotFoundException) | ||
| { | ||
| System.out.print("FileNotFoundException encountered: "); | ||
| System.out.println(fileNotFoundException.getMessage()); | ||
| System.exit(-1); | ||
| } | ||
| catch (StorageException storageException) | ||
| { | ||
| System.out.print("StorageException encountered: "); | ||
| System.out.println(storageException.getMessage()); | ||
| System.exit(-1); | ||
| } | ||
| catch (Exception e) | ||
| { | ||
| System.out.print("Exception encountered: "); | ||
| System.out.println(e.getMessage()); | ||
| System.exit(-1); | ||
| } | ||
|
|
||
| } | ||
| } | ||
|
|
||
| #Need Help? | ||
|
|
||
| Be sure to check out the Windows Azure [Developer Forums on Stack Overflow](http://go.microsoft.com/fwlink/?LinkId=234489) if you have trouble with the provided code. | ||
|
There was a problem hiding this comment. These lines are too long which will look differently on different platform. Especially in VI/VIM, it will be hard to scroll down. The right way is to add a \n at character 80. There was a problem hiding this comment. Won't fix. The primary use case for this MD file is to be converted to HTML for display in the browser. |
||
|
|
||
| #Contribute Code or Provide Feedback | ||
|
|
||
| If you would like to become an active contributor to this project please follow the instructions provided in [Windows Azure Projects Contribution Guidelines](http://windowsazure.github.com/guidelines.html). | ||
|
|
||
| If you encounter any bugs with the library please file an issue in the [Issues](https://github.com/WindowsAzure/azure-sdk-for-java/issues) section of the project. | ||
|
|
||
| #Learn More | ||
|
|
||
| * [Windows Azure Java Developer Center](http://www.windowsazure.com/en-us/develop/java/) | ||
| * [JavaDocs](http://dl.windowsazure.com/javadoc/) | ||
|
|
||
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
It seems this line is incomplete.
2 min later, actually, I think it is because a github bug, I cannot see the rest of the line, I think we should add an enter at character 80 so that the file will look consistent across different system.