02 TA80 INTG020 GosuForIntegration

Gosu for Integration
October 15, 2013
© Guidewire Software, Inc. 2001-2013. All rights reserved.

Do not distribute without permission.
Lesson objectives
• By the end of this lesson, you should be able to:
- Describe the places where an integration developer uses Gosu
- Create Gosu classes
- Use blocks as input parameters
- Generate unique, sequential numbers
This lesson uses the notes section for additional explanation and information.
To view the notes in PowerPoint, select View  Normal or View  Notes Page.
When printing notes, select Note Pages and Print hidden slides.
© Guidewire Software, Inc. 2001-2013. All rights reserved. Do not distribute without permission. 2
Lesson outline
• Overview of Gosu for integration
• Gosu classes
• Blocks
• Sequential numbers
Review: Guidewire Gosu
• Gosu is Guidewire’s open-source, publicly available
programming language
- Has elements of both procedural and object-oriented programming
languages
- Similar to JavaScript and Java
• Gosu specifies runtime business logic that:

- Executes fundamental application behavior
- Manages complex business processes
- Specifies dynamic client-side behavior
Where is Gosu used for integration? (1)
• Predefined plugins
- Executes fundamental application
behavior, such as authentication
• Startable plugins
- Specifies how to listen for incoming
messages initiated by external systems
and how to reply to them
• Messaging plugins
- Asynchronously sends messages and
processes acknowledgements
• Messaging
- Event Fired rules
- Creates messages and generates payloads
Where is Gosu used for integration? (2)
• Batch processes
- Specifies logic to run on a periodic basis
• Web services
- Specifies methods made available to
external applications for synchronous web WS-I
service calls
• Integration logic triggers include:

- Non-messaging business rules
- PCF actions (such as button clicks)
- Workflows
Gosu features and benefits
• Code is more compact
- Direct access to Guidewire data model
• Development time is shorter

- Reload Classes or Make Project
• Guidewire Studio supports Gosu coding

- Code completion
- Syntax checking
- Navigable links
• Robust interaction with Java

- Easy to learn by Java programmers
- Has access to all Java types and can reference Java classes
Gosu skills fundamental for integration
• Integration points involve these skills:
- Creating and modifying classes, including:
- Declaring and referencing properties and
methods
- Extending classes
- Creating and implementing interfaces
- Using blocks as input parameters
- Generating unique or sequential numbers
- Writing queries to retrieve data from the
Guidewire database
- Manually committing data to the database
- Using existing Java types and classes
Additional Gosu features
• Advanced • Data • Testing
object-oriented transformation - Entity builders
design - The XmlElement - GUnit tests
- Enums class (to import,
- Generics modify, and/or
export XML)
- Custom
- The typecode
annotations
mapper (to map
- Numeric literals
Guidewire
- Intervals typecodes to
- Null-safe external system
operators typecodes and
vice versa)
Lesson outline
• Gosu classes
• Blocks
Gosu class features
• Gosu classes are similar to classes in other object-oriented
language, such as Java
• Classes are organized in packages
• Classes can define:
- Constructors
- Properties (with private and public access)
- Methods (with private and public access)
• Classes can:
- Extend other classes
- Implement interfaces
- Override methods
Creating Gosu packages
• /configuration/gsrc/
- Create package
- New  Package
• Guidewire naming convention recommendation

- <company>.<app_code>.mechanism.<functional_area>
- mechanism is typically batch, messaging, plugin, startable,
webservice, and of none of the others apply, then use class
Creating Gosu classes
• Naming convention
for a class:
- <meaningfulName>API
• New class file has empty

constructor
Methods
• Methods are declared using the keyword function

- Methods can be private or public
• Like Java, methods can refer to the instance from which

the method is called using the key word this
Properties
• In Gosu, a property is a private variable whose value is

manipulated publicly through getters and setters
• Shorthand is to declare the property with the as keyword
- private var _label: String as Label
Extending a class
• To extend a class
- add extends
superClass to the class
declaration
• Super keyword gives
you access to aspects
of the superclass
• Override keyword lets
you override methods
Access to declared in the super
inherited
properties class
• As declared in the superclass, the class can access

non-private properties and methods
Logging
• Write to the log using the logger class

- gw.api.util.Logger.logTypeXX("logString")
- TypeXXX is for
- Trace, Debug, Info, Warn,
- Error
Exception handling
• Gosu can make use of try...catch...finally blocks

• Gosu code can throw Gosu and Java exceptions
Gosu classes support annotations
• An annotation is an expression starting with an "@" that

provides metadata about a Gosu element
• Gosu provides four annotations for general class and
method documentation (as shown above)
Lesson outline
• Gosu classes
• Blocks
Blocks
• A block is an unnamed method that is typically created as
an input parameter for another method
- For example, an array's where() method takes a block that specifies
a certain criteria and returns the elements in the array that match
that criteria
Block syntax
• Syntax: (\argument(s) -> logicToExecute)
var generalNotes =
aContact.ContactNotes.where(\note ->
note.ContactNoteType == "general")
• In most cases, the object is iterable
• "note" is a placeholder name for elements from the array
• The where method returns all members of the array where
the block's Boolean condition is true
Lesson outline
• Gosu classes
• Blocks
The sequence utility
• The sequence utility is a Guidewire class that is used to
generate unique, sequential numbers
- Useful for business cases requiring numbers that are sequential or
unique
• The Guidewire database stores sequence information
- For each sequence, it maintains a record of the last number
provided
• The next() method is used to request numbers
- The database provides the next number in the given sequence
Using the sequence utility
• Syntax: gw.api.system.database.
SequenceUtil.next(minVal, seqKey)
SequenceUtil in action
• Gosu Scratchpad
- Line 3:
- First call "abc"
- Line 4: Call "abc"
- Second call "abc"
Call "abc"
- Line 5:
Call "xyz"
- Third call with "xyz"
Lesson objectives review
• You should now be able to:
- Describe the places where an integration developer uses Gosu
- Create Gosu classes
- Use blocks as input parameters
- Generate unique, sequential numbers
Review questions
1. A Gosu class is named Circle. Each instance must have a
property for the circle's radius. (This value can be
accessed and modified by methods in the Circle class, but
not by methods in other classes). How many elements
must you create to implement this?
2. The Circle class extends the Oval class and implements
the ICurveLine interface.
- Can Circle override methods from Oval?
- Can Circle override methods from ICurveLine?
3. What is the purpose of an annotation?

4. What types of methods make use of blocks?
5. (continued)
Review questions
5. If the only sequence in the database has a key of "abc"
and the last number issued for sequence "abc" was 7,
what will be the return value of the following:
- SequenceUtil.next(1, "abc")
- SequenceUtil.next(15, "abc")
- SequenceUtil.next(1, "cba")
Notices
Copyright © 2001-2013 Guidewire Software, Inc. All rights reserved.
Guidewire, Guidewire Software, Guidewire ClaimCenter, Guidewire PolicyCenter,

Guidewire BillingCenter, Guidewire Reinsurance Management, Guidewire
ContactManager, Guidewire Vendor Data Management, Guidewire Client Data
Management, Guidewire Rating Management, Guidewire InsuranceSuite, Guidewire
ContactCenter, Guidewire Studio, Guidewire Product Designer, Guidewire Live, Guidewire
ExampleCenter, Gosu, Deliver Insurance Your Way, and the Guidewire logo are
trademarks, service marks, or registered trademarks of Guidewire Software, Inc. in the
United States and/or other countries. Guidewire products are protected by one or more
United States patents.
This material is Guidewire proprietary and confidential. The contents of this material,
including product architecture details and APIs, are considered confidential and are fully
protected by customer licensing confidentiality agreements and signed Non-Disclosure
Agreements (NDAs).
This file and the contents herein are the property of Guidewire Software, Inc. Use of this
course material is restricted to students officially registered in this specific Guidewire-
instructed course, or for other use expressly authorized by Guidewire. Replication or
distribution of this course material in electronic, paper, or other format is prohibited without
express permission from Guidewire.

02 TA80 INTG020 GosuForIntegration

Uploaded by

Copyright:

Available Formats

02 TA80 INTG020 GosuForIntegration

Uploaded by

Document Information

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

02 TA80 INTG020 GosuForIntegration

Uploaded by

Copyright:

Available Formats

Gosu for Integration

October 15, 2013

© Guidewire Software, Inc. 2001-2013. All rights reserved.

• Overview of Gosu for integration

• Gosu specifies runtime business logic that:

• Integration logic triggers include:

• Development time is shorter

• Guidewire Studio supports Gosu coding

• Robust interaction with Java

• Overview of Gosu for integration

• Guidewire naming convention recommendation

• New class file has empty

• Methods are declared using the keyword function

• Like Java, methods can refer to the instance from which

• In Gosu, a property is a private variable whose value is

• As declared in the superclass, the class can access

• Write to the log using the logger class

• Gosu can make use of try...catch...finally blocks

• An annotation is an expression starting with an "@" that

• Overview of Gosu for integration

• Overview of Gosu for integration

3. What is the purpose of an annotation?

Guidewire, Guidewire Software, Guidewire ClaimCenter, Guidewire PolicyCenter,

You might also like