You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/upgrade-to-v3.md
+11-11Lines changed: 11 additions & 11 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -116,13 +116,6 @@ To provide a standard and modern way of executing requests asynchronuously to SD
116
116
});
117
117
```
118
118
119
-
### Non-generated code moved to the core library
120
-
121
-
The service library (microsoft-graph) was designed to contain only code that has been generated automatically from the API metadata. All code that has been manually handcrafted should live in the core library (microsoft-graph-core).This principle makes reusability of code easier for consumers and it was not respected until thisnew version of the SDK. All the code living under anything but `com.microsoft.graph.models` or `com.microsoft.graph.requests` have been moved to the same package name in the core asset. This move should be transparent to consumers, except for the following that needs to be updated. To upgrade your application do the following.
122
-
123
-
- Replace any reference to `ChunkUploadProvider` from `com.microsoft.graph.requests.extensions` to `com.microsoft.graph.concurrency`.
124
-
- Replace any reference to `CustomRequestBuilder`, `DateOnly`, `TimeOfDay`, and `Multipart` from `com.microsoft.graph.(models|requests).extensions` to `com.microsoft.graph.core`.
125
-
126
119
### Removal of connection configuration
127
120
128
121
As the connection configuration evolved over time, the connection configuration infrastructure had become redundant with the native library configuration capabilities. To upgrade your application do the following.
@@ -152,7 +145,7 @@ To simplify the object model of the SDK, `BaseGraphServiceClient` has been merge
152
145
153
146
Requests, request builders, and responses have been refactored to take advantage of generic types. This maximizes code reusability improving performances, binary size and more. These changes should be transparent to most SDK consumers but it's possible to impact developers calling the SDK using reflection techniques.
154
147
155
-
## Batch object model improvements
148
+
### Batch object model improvements
156
149
157
150
The object model for JSON batching has been improved to provide a cleaner API surface to SDK users. To upgrade your application do the following.
158
151
@@ -231,7 +224,7 @@ The chunked upload provider has been renamed to large file upload task and moved
@@ -254,7 +247,14 @@ The chunked upload provider has been renamed to large file upload task and moved
254
247
255
248
> Note: The **LargeFileUploadTask** now also provides an **uploadAsync** method to perform uploads in the background.
256
249
257
-
## Upgrade guide for non-breaking improvments
250
+
### Non-generated code moved to the core library
251
+
252
+
The service library (microsoft-graph) was designed to contain only code that has been generated automatically from the API metadata. All code that has been manually handcrafted should live in the core library (microsoft-graph-core). This principle makes reusability of code easier for consumers and it was not respected until this new version of the SDK. All the code living under anything but `com.microsoft.graph.models` or `com.microsoft.graph.requests` have been moved to the same package name in the core asset. This move should be transparent to consumers, except for the following that needs to be updated. To upgrade your application do the following.
253
+
254
+
- Replace any reference to `ChunkUploadProvider` as showed above.
255
+
- Replace any reference to `CustomRequestBuilder`, `DateOnly`, `TimeOfDay`, and `Multipart` from `com.microsoft.graph.(models|requests).extensions` to `com.microsoft.graph.core`.
256
+
257
+
## Upgrade guide for non-breaking improvements
258
258
259
259
This section lists out other improvements which are not considered as breaking changes. SDK users are strongly encouraged to take advantage of those new improvements to simplify their code.
260
260
@@ -302,7 +302,7 @@ The SDK now produces methods to include the count of items included in collectio
302
302
303
303
> Note: support for `filter`, `orderBy`, `top`, `skip`, `skipToken`, and `expand` was also added in the last 2.X versions, if you are upgrading from an older version you might want to consider updating the use of query options by these new methods.
304
304
305
-
## Support for inherited OData methods
305
+
### Support for inherited OData methods
306
306
307
307
The SDK now produces methods in child request builder types for the parents'OData methods (actions & functions).This change allows you to write more specific requests reducing the permissions required for your application.
0 commit comments