Skip to content

Conversation

@mickjermsurawong-stripe
Copy link
Contributor

@mickjermsurawong-stripe mickjermsurawong-stripe commented Apr 9, 2019

  • Fixes more doc on getting deserialized event data object
    r? @ob-stripe

* concrete class for abstract {@code StripeObject}) schema. This is when
* {@link Event#getApiVersion()} matches {@link Stripe#API_VERSION}.
* @return stripe object that fully represent its original raw JSON response.
* Gets optional of data event object, in favor of the deprecated {@link EventData#getObject()}.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'd explicitly indicate that "optional" here refers to the type Optional<T> because otherwise the the grammar doesn't make sense.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

==. Maybe {@link java.util.Optional} would work? Otherwise {@code Optional<T>} is probably explicit enough too.

@mickjermsurawong-stripe
Copy link
Contributor Author

thank you brandur! I made the changes.
ptal @brandur-stripe

@mickjermsurawong-stripe mickjermsurawong-stripe changed the title Fix more docs Fix docs on getting stripe object from EventDataObjectDeserializer Apr 9, 2019
* concrete class for abstract {@code StripeObject}) schema. This is when
* {@link Event#getApiVersion()} matches {@link Stripe#API_VERSION}.
* @return stripe object that fully represent its original raw JSON response.
* Gets an option of data event object, in favor of the deprecated {@link EventData#getObject()}.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nice Mick! Looks mostly fine, but I'd probably also go with what OB suggested and make "option" a link or code:

==. Maybe {@link java.util.Optional} would work? Otherwise {@code Optional} is probably explicit enough too.

@brandur-stripe
Copy link
Contributor

ptal @mickjermsurawong-stripe

@mickjermsurawong-stripe
Copy link
Contributor Author

Addressed the feedback!
ptal @brandur-stripe

@brandur-stripe
Copy link
Contributor

brandur-stripe commented Apr 9, 2019

@mickjermsurawong-stripe Ah, I meant the "option" on this line specifically in the description:

Gets an option of data event object, in favor of the deprecated ...

@mickjermsurawong-stripe
Copy link
Contributor Author

mickjermsurawong-stripe commented Apr 9, 2019

whoops sorry I misunderstood..
Now using "optional" consistently, but only the first mention and last mention (@return) will have
{@code Optional}
ptal @brandur-stripe

@mickjermsurawong-stripe
Copy link
Contributor Author

thank you Brandur!

@mickjermsurawong-stripe mickjermsurawong-stripe merged commit 23b0e5f into integration-v9 Apr 9, 2019
mickjermsurawong-stripe pushed a commit that referenced this pull request Apr 9, 2019
* Drop support for Java 1.7

* Upgrade dev dependencies (except JUnit)

* Upgrade to JUnit 5

* Use ErrorProne in builds

* Return unsafe deserialized event data object as Option (#723)

* return as option

* update doc

* Autogen params (#705)

* test: typed param setup - fix ambiguous call with null casting

test: CardTest ambiguous call with typed param

* Basic primitives for typed params  (#679)

* extract common deserializer method

extract common logic

* implement ApiParamRequest

add api param request

* Add to base test lenient request params comparison for list/array int/long comparison

* use List<Object> instead of Object[] in untyped deserializer

* provide documentation to deserializer and api request param

* reorder import statments

* fix other imports in new files

* test: Standardization consider request param as map param

* rename and add more test (#718)

* Fix remaining ErrorProne warnings

* Verify deserialized boolean params to map (#722)

* verify boolean behavior

* add suppress warning

* Generated for V9.0 [generated] source: spec3.sdk.yaml@non-master-spec-fb07de8 in mickjer… (#711)

* test: typed params path query expand and limit

* test: typed params on methods previously had params as string constant

* test: typed params on polymoprhic of EMPTY and array

test: use new empty param

* test: typed params on inner object

* test: typed params by collection methods

* test: typed param fix to singular

* test: typed param create token with different instruments

test: Token with ObjectType enum

test: typed params create token

* test: typed params create charge

test: typed params charge

* generated: param

* generated: model

* generated: param

* [generated] source: spec3.sdk.yaml@non-master-spec-d9e92b9 in mickjermsurawong/working-autogen

* [ErrorProne fix: add @OverRide to enum get value][generated] source: spec3.sdk.yaml@non-master-spec-d9e92b9 in mickjermsurawong/working-autogen

* [Rename Number to card details][generated] source: spec3.sdk.yaml@non-master-spec-c5dbddd in mickjermsurawong/working-autogen

* [Sort setter methods][generated] source: spec3.sdk.yaml@non-master-spec-97a62f7 in gen-param-default

* test: remove getters from params

* test: create webhook with event enums

* test: typed param addAll/putAll

* [generated] source: spec3.sdk.yaml@non-master-spec-6e9fab7 in mickjermsurawong/default-gen-param

* Update doc on previous attributes array representation (#726)

* update doc about array representation

* fix another typo

* Another dependency version bump

* Fix docs on getting stripe object from `EventDataObjectDeserializer` (#727)

* update docs on get object

* Add missing Javadoc

* Add non-autogen typed params Event/File/EphemeralKeys (#730)

* file create params with handling of file object

* create file with typed params

* list file with typed params

update import order on files

refactor file test

* add ephemeral key create params

* add event list params

* null check for typed parameters
@ob-stripe ob-stripe deleted the mickjermsurawong/fix-more-docs branch April 10, 2019 16:34
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants