1269
Groovy Documentation Groovy Introduction Getting Started Guide User Guide Advanced Usage Guide Cookbook Examples Testing Guide Developer Guide Modules FAQ
Groovy - The Codehaus
-
Upload
others
-
View
1
-
Download
0
Embed Size (px)
Citation preview
Groovy Documentation.docxIntroduction to Groovy
Groovy Introduction Groovy...
• is an agile and dynamic language for the Java Virtual Machine •
builds upon the strengths of Java but has additional power
features inspired by languages like Python, Ruby and Smalltalk •
makes modern programming features available to Java
developers with almost-zero learning curve • supports
Domain-Specific Languages and other compact
syntax so your code becomes easy to read and maintain • makes
writing shell and build scripts easy with its powerful
processing primitives, OO abilities and an Ant DSL • increases
developer productivity by reducing scaffolding
code when developing web, GUI, database or console applications •
simplifies testing by supporting unit testing and mocking
out-of-the-box • seamlessly integrates with all existing Java
objects and libraries • compiles straight to Java bytecode so you
can use it anywhere you can use Java
Samples A simple hello world script:
def name='World'; println "Hello $name!"
A more sophisticated version using Object Orientation: class Greet
{ def name Greet(who) { name = who[0].toUpperCase() + who[1..-1] }
def salute() { println "Hello $name!" } } g = new Greet('world') //
create object g.salute() // Output "Hello World!"
Leveraging existing Java libraries:
On the command line:
groovy -e "println 'Hello ' + args[0]" World
Ø·¬±®§ Ò»© º»¿¬«®» ¿²¼ ·³°®±ª»³»²¬ ·² Ù®±±ª§ ïòéæ
ß²±²§³±« ײ²»® Ý´¿» ¿²¼ Ò»¬»¼ ͬ¿¬·½ Ý´¿» ß²²±¬¿¬·±²
»²¸¿²½»³»²¬ Ù®¿°» »²¸¿²½»³»²¬ б©»® ß»®¬ ßÍÌ »²¸¿²½»³»²¬æ ßÍÌ
Ê·»©»® ¿²¼ ßÍÌ Þ«·´¼»® ß¾·´·¬§ ¬± ½«¬±³·¦» ¬¸» Ù®±±ª§ Ì®«¬¸
Ü»°»²¼»²½§ «°¹®¿¼» λ©®·¬» ±º Ù®±±ª§Í½®·°¬Û²¹·²» Ù®±±ª§Ý±²±´»
»²¸¿²½»³»²¬ ÍÏÔ ¾¿¬½¸ «°¼¿¬» ¿²¼ ¬®¿²¿½¬·±² Ó±®» ¼»¬¿·´æ
Ù®±±ª§ ïòé ®»´»¿» ²±¬»
Ò»© º»¿¬«®» ¿²¼ ·³°®±ª»³»²¬ ·² Ù®±±ª§ ïòêæ
Ù®»¿¬ ®«²¬·³» °»®º±®³¿²½» ·³°®±ª»³»²¬ Ó«´¬·°´» ¿·¹²³»²¬ó
±°¬·±²¿´ ®»¬«®² ·² ·ºñ»´» ¿²¼ ¬®§ñ½¿¬½¸ ¾´±½µ ßÍÌ ¬®¿²º±®³¿¬·±²
¿²¼ ¿´´ ¬¸» °®±ª·¼»¼ ¬®¿²º±®³¿¬·±² ¿²²±¬¿¬·±² ´·µ» àÍ·²¹´»¬±²ô
àÔ¿¦§ô à׳³«¬¿¾´»ô àÜ»´»¹¿¬» ¿²¼ º®·»²¼ ̸» Ù®¿°» ³±¼«´» ¿²¼
¼»°»²¼»²½§ §¬»³ ¿²¼ ·¬ àÙ®¿¾ ¬®¿²º±®³¿¬·±² Ê¿®·±« Í©·²¹
¾«·´¼»® ·³°®±ª»³»²¬ô ¬¸¿²µ ¬± ¬¸» Í©·²¹ ñ Ù®·ºº±² ø ÷
¬»¿³¸¬¬°æññ¹®·ºº±²ò½±¼»¸¿«ò±®¹ ß ©»´´ ¿ »ª»®¿´ Í©·²¹ ½±²±´»
·³°®±ª»³»²¬ ̸» ·²¬»¹®¿¬·±² ±º ÖÓÈ ¾«·´¼»® ÖÍÎóîîí ½®·°¬·²¹
»²¹·²» ¾«·´¬ó·² Ê¿®·±« ³»¬¿°®±¹®¿³³·²¹ ·³°®±ª»³»²¬ô ´·µ» ¬¸» ÛÓÝ
ÜÍÔô °»®ó·²¬¿²½» ³»¬¿½´¿» »ª»² º±® ÐÑÖÑô ¿²¼ ®«²¬·³» ³·¨·²
Ó±®» ¼»¬¿·´æ ײº±¯
Ò»© º»¿¬«®» ¿²¼ ·³°®±ª»³»²¬ ·² Ù®±±ª§ ïòëæ
ײ¬»¹®¿¬» Ö¿ª¿ ë º»¿¬«®»æ ¿²²±¬¿¬·±²ô ¹»²»®·½ô ¬¿¬·½ ·³°±®¬
¿²¼ »²«³ Ò»© ³»¬¿ó°®±¹®¿³³·²¹ ½¿°¿¾·´·¬·» ß º»© §²¬¿¨
»²¸¿²½»³»²¬ ¸¿ª» ¿´± º±«²¼ ¬¸»·® ©¿§ ·²¬± ·¬ ¬± ¸»´° »¿» ¬¸»
¼»ª»´±°³»²¬ ±º ܱ³¿·²óÍ°»½·º·½ Ô¿²¹«¿¹» Ù®±±ª§ù Í©·²¹ ¾«·´¼»®
«°°±®¬ô ¬± ¸»´° §±« ¾«·´¼ Í©·²¹ Ë×ô ¸¿ ¿´³±¬ ½±³°´»¬»´§ ¾»»²
®»©®·¬¬»² ¿²¼ °·½»¼ «° ©·¬¸ »ª»®¿´ «»º«´ ¿¼¼·¬·±² ß ¹®»¿¬
¿¬¬»²¬·±² ¬± °»®º±®³¿²½» ·³°®±ª»³»²¬ ³¿¼» ¬¸· ²»© ª»®·±² ³«½¸ ß
¶±·²¬ Ö¿ª¿ ñ Ù®±±ª§ ½±³°·´»® ¬± ´»¬ §±« ³·¨ ¿²¼ ³¿¬½¸ Ù®±±ª§ ¿²¼
Ö¿ª¿ ½´¿» ·² ¬¸» ¿³» ½±³°·´¿¬·±² ¬»° ß Ù®±±ª§Ü±½ »¯«·ª¿´»²¬ ¬±
Ö¿ª¿Ü±½ ´»¬ §±« ¼±½«³»²¬ §±«® Ù®±±ª§ ½´¿» ß ®»©®·¬¬»²
·²¬»®¿½¬·ª» ¸»´´ · ²±© ®»¿´´§ ·²¬»®¿½¬·ª» ¿²¼ °®±ª·¼» «»º«´
½±³³¿²¼ ½±³°´»¬·±² º±® ³¿µ·²¹ §±« ³±®» °®±¼«½¬·ª» ̸» Ù®±±ª§ Í©·²¹
½±²±´» ¸¿ ¿´± ¾»»² ·³°®±ª»¼ Ó±®» ¼»¬¿·´æ ײº±¯
Ù®±±ª§ ïòé ®»´»¿» ²±¬»
ݱª»®¿¹» ±º ¬¸»» ²±¬» ̸» ¾»´±© ®»´»¿» ²±¬» ½«®®»²¬´§ ½±ª»® ¬¸»
²»© º»¿¬«®» ±º Ù®±±ª§ ïòéô ±«® ´¿¬»¬ ³¿¶±® ®»´»¿»ò
×ÜÛ Í«°°±®¬ Þ»º±®» ¼·ª·²¹ ¼·®»½¬´§ ·²¬± ¬¸» ²»© º»¿¬«®» ·² Ù®±±ª§
ïòéô °´»¿» ´»¬ ³» ³»²¬·±² ¬¸» ¹®»¿¬ °®±¹®» ³¿¼» ·² ¬»®³ ±º ×ÜÛ
«°°±®¬ º±® Ù®±±ª§ ø¿²¼ ¿´± º±® ô ô ±® ÷ò ß´´ ¬¸» ³¿¶±® ×ÜÛ
øÛ½´·°»ô ô ÷ °®±ª·¼» ¿² »¨½»´´»²¬ ´»ª»´ ±º «°°±®¬ º±® ¬¸»Ù®·ºº±²
Ù®¿¼´» Ù¿²¬ Ù®¿·´ ײ¬»´´·Ö ×ÜÛß Ò»¬Þ»¿² ´¿²¹«¿¹»ò ײ·¬·¿´´§ô ¬¸»
Û½´·°» «°°±®¬ ©¿ ¬¸» ±²» ´¿½µ·²¹ ¬¸» ³±¬ô ¾«¬ ¬¸¿²µ ¬± ¬¸»
¸¿®¼ ©±®µ ±º ¬¸» Í°®·²¹Í±«®½» Û½´·°» ¬»¿³ô ©» ²±© ¸¿ª» ¿ ¹®»¿¬
»²ª·®±²³»²¬ º±® ¼»ª»´±°·²¹ ³·¨»¼ Ö¿ª¿ ñ Ù®±±ª§ ¿°°´·½¿¬·±² ©·¬¸
º»¿¬«®» ´·µ» ½®±ó´¿²¹«¿¹» ®»º¿½¬±®·²¹ô Ù®±±ª§ó°»½·º·½ ½±¼»
½±³°´»¬·±²ô ¿²¼ ³±®»ò
Ò»© ¿²¼ ׳°®±ª»¼ Û½´·°» °´«¹·² Ú±® ³±®» ·²º±®³¿¬·±² ±² ¬¸» Û½´·°»
«°°±®¬ô °´»¿» ¸¿ª» ¿ ´±±µ ¿¬ ¬¸» ô ¿ ©»´´ ¿ ¬¸» ²±¬»Ù®±±ª§
Û½´·°» °´«¹·² ¸±³» °¿¹» º±® ¬¸» ¿²¼ òÓï ®»´»¿» Óî ®»´»¿»
Ò»© º»¿¬«®»
ß²±²§³±« ײ²»® Ý´¿» ¿²¼ Ò»¬»¼ Ý´¿»
ß´¬¸±«¹¸ ±º¬»²¬·³» ½´±«®» ¿²¼ ³¿° ½±»®½·±² «ºº·½»ô ¬¸»®» ¿®»
¬·´´ ¿®»¿ ©¸»®» ¬¸» ´¿½µ ±º ß²±²§³±« ײ²»® Ý´¿» øß×Ý÷ ¿²¼
Ò»¬»¼ Ý´¿» øÒÝ÷ ½¿² ¾» °®±¾´»³¿¬·½ò ̸¿¬ù ©¸§ ©» ¼»½·¼»¼ ¬±
»ª»²¬«¿´´§ ·³°´»³»²¬ ß×Ý ¿²¼ ÒÝ ·² Ù®±±ª§ ïòéò
Þ» Ý¿®»º«´ ̸» ·³°´»³»²¬¿¬·±² ±º ß×Ý ¿²¼ ÒÝ º±´´±© ¬¸» Ö¿ª¿ ´»¿¼ô
¾«¬ §±« ¸±«´¼ ²±¬ ¬¿µ» ±«¬ ¬¸» Ö¿ª¿ Ô¿²¹«¿¹» Í°»½ ¿²¼ µ»»° ¸¿µ·²¹
¬¸» ¸»¿¼ ¿¾±«¬ ¬¸·²¹ ¬¸¿¬ ¿®» ¼·ºº»®»²¬ò ̸» ·³°´»³»²¬¿¬·±² ¼±²»
´±±µ ³«½¸ ´·µ» ©¸¿¬ ©» ¼± º±® ¹®±±ª§ò´¿²¹òÝ´±«®»ô ©·¬¸ ±³»
¾»²»º·¬ ¿²¼ ±³» ¼·ºº»®»²½»ò ß½½»·²¹ °®·ª¿¬» º·»´¼ ¿²¼ ³»¬¸±¼
º±® »¨¿³°´» ½¿² ¾»½±³» ¿ °®±¾´»³ô ¾«¬ ±² ¬¸» ±¬¸»® ¸¿²¼ ´±½¿´
ª¿®·¿¾´» ¼±²ù¬ ¸¿ª» ¬± ¾» º·²¿´ò
Ò»¬»¼ ͬ¿¬·½ Ý´¿»
Ø»®»ù ¿² »¨¿³°´» ±º Ò»¬»¼ ͬ¿¬·½ Ý´¿»æ
½´¿ ß ¥ ½´¿ Þ ¥£¬¿¬·½
£
ßòÞø÷²»©
̸» «¿¹» ±º ¬¿¬·½ ²»¬»¼ ½´¿» · ¬¸» ¾»¬ «°°±®¬»¼ ±²»ò ׺
§±« ¿¾±´«¬»´§ ²»»¼ ¿² ·²²»® ½´¿ô §±« ¸±«´¼ ³¿µ» ·¬ ¿ ¬¿¬·½
±²»ò
ß²±²§³±« ײ²»® Ý´¿»
ͱ³» ±¬¸»® »¨¿³°´»ô ¬¸· ¬·³» º±® ß²±²§³±« ײ²»® Ý´¿»æ
¾±±´»¿² ½¿´´»¼ ã º¿´»
Ì·³»® ¬·³»® ã Ì·³»®ø÷²»© ¬·³»®ò½¸»¼«´»ø Ì·³»®Ì¿µø÷ ¥²»© ª±·¼
®«²ø÷ ¥ ½¿´´»¼ ã ¬®«» £ £ô ð÷ ´»»° ïðð
½¿´´»¼¿»®¬
Ó±®» ·²º±®³¿¬·±² ׺ §±« ©¿²¬ ¬± ´»¿®² ¿ ¾·¬ ³±®» ¿¾±«¬ ¬¸» ½¿»
©¸·½¸ ¿®» ½«®®»²¬´§ «°°±®¬»¼ ·² ïòéô §±« ½¿² ¸¿ª» ¿ ´±±µ ¿¬ ±²» ±º
±«® «²·¬ ¬»¬ ½±ª»®·²¹ ¬¸· ²»© º»¿¬«®»ò
ß½½»·²¹ ¬¸» Ñ«¬»® ݱ²¬»¨¬ º®±³ ¿ Ò»¬»¼ Ý´¿
׺ §±« ¿®» ·² ¿ ²»¬»¼ ½´¿ Ç ¿²¼ ¬¸» «®®±«²¼·²¹ ½´¿ · Èô ¬¸»²
§±« ½¿² ¿½½» ¬¸» ª¿®·¿¾´» ª ±º È ·² Ö¿ª¿ ¾§ Èò¬¸·òªò Ù®±±ª§ ¼±»
²±¬ «°°±®¬ ¬¸· §²¬¿¨ò
Ý®»¿¬·²¹ ײ¬¿²½» ±º Ò±²óͬ¿¬·½ ײ²»® Ý´¿»
ײ Ö¿ª¿ §±« ½¿² ¼± ¬¸·æ
°«¾´·½ ½´¿ Ç ¥ ½´¿ È ¥£°«¾´·½ È º±±ø÷ ¥°«¾´·½
Èø÷å®»¬«®² ²»© £
£ £
׬ ¸±«´¼ ¾» ²±¬»¼ ¬¸¿¬ ¬¸» ²»¬»¼ ½´¿ È ²»»¼ ¿ ®»º»®»²½» ¬± ¬¸»
±«¬»® ½´¿ ·²¬¿²½» ±º Çò Ú±® ¬¸· Ö¿ª¿ ©·´´ ½®»¿¬» ¿ ½±²¬®«½¬±®
¬¸¿¬ ¬¿µ» Ç ¿ º·®¬ °¿®¿³»¬»® ·² Èò ̸· ½±²¬®«½¬±® ·
§²¬¸»¬·½ô ± ·¬ ©±²ù¬ ¿°°»¿® ·² ¿²§ ½±¼» ½±³°´»¬·±²ò ײ ½¿» ±º
²»© Èø÷ô ´·µ» §±« ¸¿ª» ·¬ ·² ³»¬¸±¼ º±±ø÷ô ¬¸»² ½±³°·´»® ©·´´ ¬¸»²
½®»¿¬» ²»© Èø¬¸·÷ ·²¬»¿¼ò ײ ½¿» ±º ½®»¿¬»È ¬¸» ½±³°·´»® ©·´´
½®»¿¬» ²»© Èø§÷ò Ù®±±ª§ ¼±» ²±¬ «°°±®¬ ¬¸·ò
ײ¬»¿¼ Ù®±±ª§ «°°±®¬ ¹·ª·²¹ ¬¸» ·²¬¿²½» ·² ´·µ» ¬¸» ½±³°·´»®
©±«´¼ ¼± ·¬ò ̸¿¬ ³»¿² ¬¸» ½±¼» ¿¾±ª» ¸¿ ¬± ¾» ®»©®·¬¬»² ¿
°«¾´·½ ½´¿ Ç ¥ ½´¿ È ¥£°«¾´·½ È º±±ø÷ ¥°«¾´·½
Èø ÷å®»¬«®² ²»© ¬¸· £
£ £
Ý¿«¬·±² Ý¿«¬·±² ¬¸±«¹¸ô Ù®±±ª§ «°°±®¬ ½¿´´·²¹ ³»¬¸±¼ ©·¬¸ ±²»
°¿®¿³»¬»® ©·¬¸±«¬ ¹·ª·²¹ ¿² ¿®¹«³»²¬ò ̸» °¿®¿³»¬»® ©·´´ ¬¸»² ¸¿ª»
¬¸» ª¿´«» ²«´´ò Þ¿·½¿´´§ ¬¸» ¿³» ®«´» ¿°°´§ ¬± ½¿´´·²¹ ¿
½±²¬®«½¬±®ò ̸»®» · ¿ ¼¿²¹»® ¬¸¿¬ §±« ©·´´ ©®·¬» ²»© Èø÷ ·²¬»¿¼
±º ²»© Èø¬¸·÷ º±® »¨¿³°´»ò Í·²½» ¬¸· ³·¹¸¬ ¿´± ¾» ¬¸» ®»¹«´¿®
©¿§ ©» ¸¿ª» ²±¬ §»¬ º±«²¼ ¿ ¹±±¼ ©¿§ ¬± °®»ª»²¬ ¬¸· °®±¾´»³ò
ß²²±¬¿¬·±²
Ù®±±ª§ù «°°±®¬ ±º ¿²²±¬¿¬·±² · ·¼»²¬·½¿´ ¬± Ö¿ª¿ ë ¿²²±¬¿¬·±²ô
¾«¬ ©» º»´¬ ¬¸¿¬ ·² ±³» ½¿» ·¬ ©±«´¼ ¾» ·²¬»®»¬·²¹ ¬± ¾» ¿¾´»
¬± ¿¼¼ ¿²²±¬¿¬·±² ·² ±¬¸»® °´¿½» ¬¸¿² ¬¸» ««¿´ °´¿½» ø¬§°»ô
º·»´¼ô ³»¬¸±¼ô °¿®¿³»¬»®ô »¬½ò÷ò Ú±® ·²¬¿²½»ô ·² Ö¿ª¿ô ·¬ ·
·³°±·¾´» ¬± ¿¼¼ ¿²²±¬¿¬·±² ±² ·³°±®¬ ±® °¿½µ¿¹»ò Ù®±±ª§ ¼±»
¹± ¾»§±²¼ ¿²¼ ¿¼¼ «°°±®¬ º±® ¿²²±¬¿¬·±² ±² ·³°±®¬ô °¿½µ¿¹» ¿²¼
ª¿®·¿¾´» ¼»½´¿®¿¬·±²ò É»ù´´ ¬¿µ» ¿ ´±±µ ¿¬ ¬¸» «¿¹» ±º ¬¸±»
»¨¬»²¼»¼ ¿²²±¬¿¬·±² ±² Ù®¿°»ò
Ù®¿°»
̸» Ù®¿°» ¼»°»²¼»²½§ §¬»³ ´»¬ §±« ®»¯«»¬ ¼»°»²¼»²½·» ·² §±«®
½®·°¬ô ©·¬¸±«¬ ¸¿ª·²¹ ¬± ¼»¿´ ©·¬¸ ¼±©²´±¿¼·²¹ô °¿½µ¿¹·²¹ô ±®
°»½·º§·²¹ ¬¸» ½´¿°¿¬¸ §±«®»´ºò ̱ «» Ù®¿°»ô ©» ¸¿¼ ¬± «» ¬¸»
àÙ®¿¾ ¿²²±¬¿¬·±² ¬± þ¹®¿¾þ ¿ ¼»°»²¼»²½§ º®±³ ¿ ®»°±·¬±®§ øÓ¿ª»²ù
½»²¬®¿´ ®»°±·¬±®§ô º±® »¨¿³°´»÷ò ̸» °®±¾´»³ ©¿ ¬¸¿¬ ¿²²±¬¿¬·±²
¸¿¼ ¬± ¾» ¿¬¬¿½¸»¼ ¬± ±³» ¿´´±©»¼ »´»³»²¬ô ·»ò ¬¸» °´¿½» ©¸»®»
¿²²±¬¿¬·±² ½¿² ¾» °«¬ ·² Ö¿ª¿ò Ò±©ô ©» ½¿² °«¬ ¿²²±¬¿¬·±² ±²
·³°±®¬æ
àÙ®¿¾ø¹®±«°ãù²»¬òºò¶±²ó´·¾ùô ³±¼«´»ãù¶±²ó´·¾ùô ª»®·±²ãùîòíùô
½´¿·º·»®ãù¶¼µïëù÷ ²»¬òºò¶±²ò¹®±±ª§òö·³°±®¬
Ö±²Í´«®°»®ø÷ò°¿®»Ì»¨¬ø¿»®¬ ²»© Ö±²Ù®±±ª§Þ«·´¼»®ø÷ò¶±²
¥²»©
¾±±µø¬·¬´»æ ô ¿«¬¸±®æ ÷þÙ®±±ª§ ·² ß½¬·±²þ þÜ·»®µ Õ*²·¹ »¬ ¿´þ
£ò¬±Í¬®·²¹ø÷ ÷ò¾±±µò¬·¬´» ãã ùÙ®±±ª§ ·² ß½¬·±²ù
ß²±¬¸»® »¨¿³°´» ©·¬¸ àÙ®¿¾ ±² ª¿®·¿¾´» ¼»½´¿®¿¬·±²æ
àÙ®¿¾øù²»¬òºò¶±²ó´·¾æ¶±²ó´·¾æîòí涼µïëù÷ ¼»º ¾«·´¼»® ã
²»¬òºò¶±²ò¹®±±ª§òÖ±²Ù®±±ª§Þ«·´¼»®ø÷²»©
¼»º ¾±±µ ã ¾«·´¼»®ò¾±±µ ¥ ¾±±µø¬·¬´»æ ô ¿«¬¸±®æ ÷þÙ®±±ª§ ·²
ß½¬·±²þ þÜ·»®µ Õ±»²·¹þ £
¾±±µò¬±Í¬®·²¹ø÷ ãã ùùù¥ æ¥ æ¥ æ ô æ¿»®¬ þ¾±±µþ þ¾±±µþ þ¬·¬´»þ
þÙ®±±ª§ ·² ß½¬·±²þ þ¿«¬¸±®þ þÜ·»®µ Õ±»²·¹þ £££ùùù
λ³¿®µ д»¿» ²±¬» ±² ¬¸· ±²» ¿² ·³°®±ª»³»²¬ ·² ¬¸» àÙ®¿¾
¿²²±¬¿¬·±²æ ©» °®±ª·¼» ¿ ¸±®¬»® ª»®·±² ¬¿µ·²¹ ¶«¬ ¿ ͬ®·²¹ ¿
ª¿´«» °¿®¿³»¬»® ®»°®»»²¬·²¹ ¬¸» ¼»°»²¼»²½§ô ·² ¿¼¼·¬·±² ¬± ¬¸»
³±®» ª»®¾±» »¨¿³°´» ·² ¬¸» °®»ª·±« »¨¿³°´»ò DZ« ·³°´§ ¿°°»²¼ ¬¸»
¹®±«°ô ³±¼«´»ô ª»®·±² ¿²¼ ½´¿·º·»® ¬±¹»¬¸»®ô ¶±·²»¼ ¾§
½±´±²ò
ß Ù®¿°» ©¿ ¿¼¼»¼ô ± §±« ½¿² °»½·º§ ¿ ®»³±¬» ´±½¿¬·±² ©¸»®»
¹®¿°» ¿®» ¼±©²´±¿¼»¼ º®±³æ®»±´ª»®
àÙ®¿¾Î»±´ª»®ø²¿³»ãù®»¬´»¬ò±®¹ùô ®±±¬ãù¸¬¬°æññ³¿ª»²ò®»¬´»¬ò±®¹ù÷
àÙ®¿¾ø¹®±«°ãù±®¹ò®»¬´»¬ùô ³±¼«´»ãù±®¹ò®»¬´»¬ùô
ª»®·±²ãùïòïòêù÷
±®¹ò®»¬´»¬òλ¬´»¬·³°±®¬ ññ òòò
б©»® ß»®¬
Ù®±±ª§ù þ¿»®¬þ µ»§©±®¼ ¸¿ ±³»¬·³» ¾»»² ½®·¬·½·¦»¼ ¿ ·¬ùô ·²
¿ ©¿§ô ´·³·¬»¼ô ¿ ·¬ ¶«¬ ½¸»½µ ¬¸¿¬ ¬¸» »¨°®»·±² ·¬ù ¾»·²¹
°¿»¼ · ¬®«» ±® º¿´»ò ˲´·µ» ©·¬¸ ¬»¬·²¹ º®¿³»©±®µ «½¸ ¿
Ö˲·¬ñÌ»¬ÒÙ ¿²¼ ¬¸» ª¿®·±« ¿¼¼·¬·±²¿´ ¿»®¬·±² «¬·´·¬·»ô ©¸»®»
§±« ¹»¬ ²·½»® ¿²¼ ³±®» ¼»½®·°¬·ª» ³»¿¹»ô Ù®±±ª§ù ¿»®¬ ©±«´¼
¶«¬ ¬»´´ §±« ¬¸» »¨°®»·±² ©¿ º¿´»ô ¿²¼ ©±«´¼ ¹·ª» ¬¸» ª¿´«» ±º
ª¿®·¿¾´» «»¼ ·² ¬¸» »¨°®»·±²ô ¾«¬ ²±¬¸·²¹ ³±®»ò É·¬¸ б©»®
ß»®¬ô ·²·¬·¿´´§ ¼»ª»´±°»¼ ·² ¬¸» ô ¬¸» ±«¬°«¬ ±º ¬¸» ¿»®¬ ·
²±© ³«½¸ ²·½»® ¿²¼ °®±ª·¼» ¿ ª·«¿´Í°±½µ Ú®¿³»©±®µ ®»°®»»²¬¿¬·±²
±º ¬¸» ª¿´«» ±º »¿½¸ «¾ó»¨°®»·±² ±º ¬¸» »¨°®»·±² ¾»·²¹
¿»®¬»¼ò Ú±® »¨¿³°´»æ
¿»®¬ Ú·´»øùº±±ò¾¿®ù÷ ãã Ú·´»øù»¨¿³°´»ò¬¨¬ù÷²»© ²»©
É·´´ §·»´¼æ
Ý¿«¹¸¬æ ß»®¬·±² º¿·´»¼æ
Ú·´»øùº±±ò¾¿®ù÷ ãã Ú·´»øù»¨¿³°´»ò¬¨¬ù÷¿»®¬ ²»© ²»© ¤ ¤ ¤ º±±ò¾¿®
¤ »¨¿³°´»ò¬¨¬
º¿´»
ßÍÌ
É·¬¸ Ù®±±ª§ ïòêô ©» ·²¬®±¼«½»¼ ßÍÌ Ì®¿²º±®³¿¬·±²ô º±® ´»¬¬·²¹
¼»ª»´±°»® ¼± ½±³°·´»ó¬·³» ³»¬¿°®±¹®¿³³·²¹ô ¾§ ³±¼·º§·²¹ ¬¸»
ß¾¬®¿½¬ ͧ²¬¿¨ Ì®»» ¾»º±®» ·¬ · ¬®¿²º±®³»¼ ·²¬± ¾§¬»½±¼»ò ײ
Ù®±±ª§ ïòêô »ª»®¿´ «½¸ ¬®¿²º±®³¿¬·±² ©»®» ¿¼¼»¼ô »°»½·¿´´§
þ´±½¿´þ ¬®¿²º±®³¿¬·±² ¬®·¹¹»®»¼ ¾§ ¿²²±¬¿¬·±² ø«½¸ ¿
àÜ»´»¹¿¬»ô àÍ·²¹´»¬±²ô àÞ·²¼¿¾´» ¿²¼ º®·»²¼÷ò ر©»ª»® °±©»®º«´
¬¸· º»¿¬«®» ·ô ©®·¬·²¹ ßÍÌ ¬®¿²º±®³¿¬·±² ¸¿ ¿´©¿§ ¾»»² ¿ ¾·¬
¬»¼·±«ò Ù®±±ª§ ïòé º»¿¬«®» ¬©± ²»© º»¿¬«®» ©¸·½¸ ¸±«´¼ ¸»´°
·³°´·º§ ¬¸» ©±®µ ±º ßÍÌ ¬®¿²º±®³¿¬·±² ©®·¬»®æ ¿² ßÍÌ ª·»©»® ¿²¼
¿² ßÍÌ ¾«·´¼»®ò
ßÍÌ Ê·»©»®
̸» º±´´±©·²¹ ½®»»²¸±¬ ¸±© ¿ ²»© ©·²¼±© ¬¸¿¬ ½¿² ¾» ´¿«²½¸»¼
º®±³ ¬¸» Ù®±±ª§ Í©·²¹ ݱ²±´»ò DZ« ½¿² ª·«¿´·¦» ¬¸» ßÍÌ ±º ¿
½®·°¬ §±«ù®» ©±®µ·²¹ ±² ·² ¬¸» ½±²±´»æ º±® ·²¬¿²½»ô ©®·¬·²¹ ¬¸»
½±¼» §±«ù¼ ´·µ» ¬± ½®»¿¬» ·² §±«® ßÍÌ ¬®¿²º±®³¿¬·±²ò ̸» ßÍÌ
ª·»©»® ¹®»¿¬´§ ¸»´° ©·¬¸ º·¹«®·²¹ ±«¬ ¸±© Ù®±±ª§ ¾«·´¼ ·¬ ßÍÌ
©¸»² ½±³°·´·²¹ §±«® Ù®±±ª§ ½±¼»ò
ßÍÌ Þ«·´¼»®
Ê·«¿´·¦·²¹ ¬¸» ßÍÌ · ±²» ¬¸·²¹ô ¾«¬ ©» ¿´± ²»»¼ ¿ ³»½¸¿²·³ ¬±
½®»¿¬» ¿²¼ ³±¼·º§ ßÍÌ ³±®» »¿·´§ò ̸» ·²¬®±¼«½¬·±² ±º ¬¸» ßÍÌ
¾«·´¼»® ·³°´·º·» ¬¸» ¿«¬¸±®·²¹ ±º ßÍÌ ¬®¿²º±®³¿¬·±²ô ¾§ ¹·ª·²¹
§±« ¬¸®»» ¼·ºº»®»²¬ ¿°°®±¿½¸» º±® ©±®µ·²¹ ±² ¬¸» ßÍÌæ
¾«·´¼·²¹ º®±³ ¬®·²¹ ¾«·´¼·²¹ º®±³ ½±¼» ¾«·´¼·²¹ º®±³
°»½·º·½¿¬·±²
Þ»º±®» ¬¸» ßÍÌ ¾«·´¼»®ô ±²» ¸¿¼ ¬± ½®»¿¬» ¿²¼ ·²¬¿²¬·¿¬» ³¿²«¿´´§
¿´´ ¬¸» ª¿®·±« ßÍÌ ²±¼»ò Ô»¬ù »» ¸±© ¬¸±» ¬¸®»» º±®³ ¸»´°
©·¬¸ ¬¸·ô º±® ·²¬¿²½» º±® ½®»¿¬·²¹ ¿ ²±¼» ®»°®»»²¬·²¹ ¿ ½±²¬¿²¬
¬®·²¹ò
Þ«·´¼·²¹ º®±³ ¬®·²¹
Ô·¬äßÍÌÒ±¼»â ²±¼» ã ߬ޫ·´¼»®ø÷ò¾«·´¼Ú®±³Í¬®·²¹øùùù ùùù÷²»©
þØ»´´±þ
Þ«·´¼·²¹ º®±³ ½±¼»
Ô·¬äßÍÌÒ±¼»â ²±¼» ã ߬ޫ·´¼»®ø÷ò¾«·´¼Ú®±³Ý±¼» ¥ £²»©
þØ»´´±þ
Þ«·´¼·²¹ º®±³ °»½·º·½¿¬·±²
Ô·¬äßÍÌÒ±¼»â ²±¼» ã ߬ޫ·´¼»®ø÷ò¾«·´¼Ú®±³Í°»½ ¥²»© ¾´±½µ ¥
®»¬«®²Í¬¿¬»³»²¬ ¥ ½±²¬¿²¬ þØ»´´±þ £ £ £
Ú±® ³±®» ·²º±®³¿¬·±² д»¿» ¸¿ª» ¿ ´±±µ ¿¬ ¬¸» ¼±½«³»²¬¿¬·±² ±² ¬¸»
ò DZ«ù´´ ¼·½±ª»® ¬¸» ¿¼ª¿²¬¿¹» ¿²¼ ·²½±²ª»²·»²½» ±º ¬¸»
ª¿®·±«ßÍÌ Þ«·´¼»® º±®³ô ¿²¼ ©¸§ ¿´´ ¬¸®»» ¿®» ²»»¼»¼ ¼»°»²¼·²¹ ±²
©¸¿¬ §±« ©¿²¬ ¬± ¿½¸·»ª» ©·¬¸ ¬¸» ßÍÌò
Ѭ¸»® ³·²±® »²¸¿²½»³»²¬
ß¾·´·¬§ ¬± ½«¬±³·¦» ¬¸» Ù®±±ª§ Ì®«¬¸
ײ Ù®±±ª§ô ¾±±´»¿² ¿®»²ù¬ ¬¸» ±´» ¬¸·²¹ ©¸·½¸ ½¿² ¾» »ª¿´«¿¬»¼
¬± ¬®«» ±® º¿´»ô ¾«¬ º±® ·²¬¿²½»ô ²«´´ô »³°¬§ ¬®·²¹ ±®
½±´´»½¬·±² ¿®» »ª¿´«¿¬»¼ ¬± º¿´» ±® ¬®«» ·º ±º ´»²¹¬¸ â ð ±®
²±²ó»³°¬§ò ̸· ²±¬·±² ±º þ¬®«¬¸þ ©¿ ½±·²»¼ þÙ®±±ª§ Ì®«¬¸þ ·² ¬¸»
¾±±µò É·¬¸ Ù®±±ª§ Ì®«¬¸ôÙ®±±ª§ ·² ß½¬·±² ·²¬»¿¼ ±º ¼±·²¹ º®»¯«»²¬
²«´´ ½¸»½µô §±« ½±«´¼ ·³°´§ ©®·¬»æ
¼»º ¬®·²¹ ã þ³±®» ¬¸¿² ±²» ½¸¿®¿½¬»®þ ø¬®·²¹÷ ¥ °®·²¬´² £·º þ¬¸»
· ²»·¬¸»® ²±® »³°¬§þͬ®·²¹ ²«´´
Ë° «²¬·´ Ù®±±ª§ ïòéô ±²´§ ¿ ³¿´´ »¬ ±º ½´¿» ¸¿¼ ¿ ½»®¬¿·²
³»¿²·²¹ ©·¬¸ ®»¹¿®¼ ¬± ¸±© ¬¸»§ ©»®» ½±»®½»¼ ¬± ¿ ¾±±´»¿² ª¿´«»ô
¾«¬ ²±© ·¬ · °±·¾´» ¬± °®±ª·¼» ¿ ³»¬¸±¼ º±® ½±»®½·±² ¬± ¾±±´»¿²
·² §±«® ±©² ½´¿»ò Ú±® »¨¿³°´»ô ¬¸» º±´´±©·²¹ Ю»¼·½¿¬» ½´¿
±ºº»® ¬¸» ¿¾·´·¬§ ¬± ½±»®½» Ю»¼·½¿¬» ·²¬¿²½» ¬± ¬®«» ±® º¿´»ô
¬¸¿²µ ¬± ¬¸» ·³°´»³»²¬¿¬·±² ±º ¬¸» ¾±±´»¿² ¿Þ±±´»¿²ø÷
³»¬¸±¼æ
£
Ю»¼·½¿¬»øª¿´«»æ ÷¿»®¬ ²»© ¬®«» ÿ Ю»¼·½¿¬»øª¿´«»æ ÷¿»®¬ ²»©
º¿´»
× · ¿´± °±·¾´» ¬± «» ½¿¬»¹±®·» ±® Û¨°¿²¼±Ó»¬¿Ý´¿ ¬± ·²¶»½¬
¿² ¿Þ±±´»¿²ø÷ ³»¬¸±¼ô ±® ¬± ±ª»®®·¼» ¿² »¨·¬·²¹ ±²» ø»ª»² ±²» ±²
¬¸» ³¿´´ »¬ ±º ½´¿» ©·¬¸ °»½·¿´ Ù®±±ª§ ¬®«¬¸ ¾»¸¿ª·±®÷ò
Ü»°»²¼»²½§ «°¹®¿¼»
ͱ³» ±º ¬¸» ¼»°»²¼»²½·» ±º Ù®±±ª§ ¸¿ª» ¾»»² «°¹®¿¼»¼ ¬± ²»©»®
ª»®·±²ò
Ú±® ·²¬¿²½»ô Ù®±±ª§ ²±© «» ¬¸» ´¿¬»¬ ßÍÓ ª»®·±²ô ©¸·½¸ ·
þ·²ª±µ»¼§²¿³·½þó®»¿¼§ò ͱ ¿ ©» °®±¹®» ¬±©¿®¼ ¬¸» ·²½´«·±² ±º
ÖÍÎóîçî ñ ·²ª±µ»¼§²¿³·½ô ©»ù´´ ¾» ®»¿¼§ ¿²¼ ¾» «·²¹ ¬¸» ´¿¬»¬
ª»®·±² ±º ßÍÓò É» ¿´± «» ¬¸» ´¿¬»¬ ª»®·±² ±º ת§ ©¸·½¸ · «»¼
¾§ ¬¸» Ù®¿°» ¼»°»²¼»²½§ ³±¼«´»ò
λ©®·¬» ±º ¬¸» Ù®±±ª§Í½®·°¬Û²¹·²»
̸» Ù®±±ª§Í½®·°¬Û²¹·²» ø©¸·½¸ · ¿´± «»¼ ¾§ Ù®±±ª´»¬÷ ¸¿ ¾»»²
®»©®·¬¬»² ¬± ±´ª» ª¿®·±« ¼»°»²¼»²½§ ·«» ·¬ ©¿ «ºº»®·²¹ º®±³ô
¿²¼ ¬¸» ±«¬½±³» ±º ¬¸· · ¬¸¿¬ ·¬ ¸±«´¼ ¿´± ²±© ¾» ³«½¸ º¿¬»®
±ª»®¿´´ò
̸» ²»© ´±¹·½ «» ¿¼¼·¬·±²¿´ °¸¿» ±°»®¿¬·±² ¬± ¬®¿½µ
¼»°»²¼»²½·»ò ß ¿ ®»«´¬ ¬¸» »®®±®ó°®±²» ½´¿ ´±¿¼»® ¬»½¸²·¯«» ¬±
¬®¿½µ ¬¸»³ · ¹±²» ²±©ò ̸»» ±°»®¿¬·±² »²«®» ¬¸¿¬ »ª»®§ ½®·°¬
º·´» ©·´´ ¾» ¬®¿½µ»¼ô ·¬ ¼»°»²¼»²½·» ®»½±®¼»¼ ¼«®·²¹ ½±³°·´¿¬·±²
¿²¼ ¿´´ ¬®¿²·¬·ª» ¼»°»²¼»²½·» ©·´´ ¾» ½¿´½«´¿¬»¼ò ß²¼ ±²´§
½®·°¬ ©·´´ ¾» ®»½±®¼»¼ ¿ ¼»°»²¼»²½§ô ²± ½´¿»ò ̸» ²»©
Ù®±±ª§Í½®·°¬Û²¹·²» ¿´± «» ±²´§ ±²» ½±³°·´¿¬·±² þ°®±½»þ º±®
½®·°¬ ½±³°·´¿¬·±² ©¸·½¸ ±´ª» ¬¸» °®±¾´»³ ±º ½·®½«´¿® ±® ³«¬«¿´
¼»°»²¼»²½·»ô ¬¸¿¬ ½¿«»¼ ¬¿½µ ±ª»®º´±© ·² ¬¸» °¿¬ò ß ¿ ®»«´¬
¬¸» ²»© »²¹·²» ½¿² ®»´·¿¾´§ ¸¿²¼´» ¼»°»²¼»²½·» ¿²¼ ¸±«´¼ ¾» ³«½¸
º¿¬»®ò
Ù®±±ª§ ½±²±´» °®»º»®»²½»
ß ³¿´´ ¿²²±§¿²½»ô »°»½·¿´´§ º±® ¼»ª»´±°»® «·²¹ ¾·¹ ÔÝÜ ½®»»²æ
¬¸» Ù®±±ª§ ݱ²±´» ¼·¼²ù¬ ®»³»³¾»® °®»º»®»²½» ±º °±·¬·±² ±º ¬¸»
»°¿®¿¬±® ¾»¬©»»² ¬¸» ½±¼·²¹ ¿®»¿ ¿²¼ ±«¬°«¬ ª·»©ô ±® ¬¸» º±²¬ ·¦»
¾»·²¹ «»¼ò ̸· · ²±© º·¨»¼ô ¿ ¬¸» ½±²±´» ®»³»³¾»® «½¸
»¬¬·²¹ò DZ« ©±²ù¬ ²»»¼ ¿²§³±®» ¬± ¿¼¶«¬ ¬¸» ½±²±´» ¬± §±«®
´·µ·²¹ »¿½¸ ¬·³» §±« ®«² ·¬ô ·¬ ¸±«´¼ ²±© ¸¿ª» ±³» ³±®» ¾®¿·²
½»´´ ¬± ®»³»³¾»® §±«® °®»º»®»²½»ò
Ò»© ±«¬°«¬ ©·²¼±© º±® ¬¸» Ù®±±ª§ ½±²±´»
̸»®» · ¿ ²»© ª·«¿´·¦¿¬·±² ±°¬·±² º±® ¬¸» ®»«´¬ ±º ¬¸»
»¨»½«¬·±² ±º §±«® ½®·°¬ ·² §±«® Ù®±±ª§ ݱ²±´»ò ײ¬»¿¼ ±º
¼·°´¿§·²¹ ¬¸» ®»«´¬ ·² ¬¸» ¾±¬¬±³ ±«¬°«¬ °¿²»ô ·¬ù ²±© °±·¾´»
¬± «» ¿² »¨¬»®²¿´ ©·²¼±© º±® ª·»©·²¹ ¬¸±» ®»«´¬ò Ϋ² §±«®
½®·°¬ ©·¬¸ ÝÌÎÔóÎ ±® ÝÓÜóÎô §±« ©·´´ »» ±³»¬¸·²¹ ´·µ» ¬¸»
º±´´±©·²¹ ½®»»²¸±¬ò DZ« ½¿² ¬¸»² ¼·³· ¬¸» ©·²¼±© ¾§ ¸·¬¬·²¹
Û½¿°»ô ÝÌÎÔóÉ øÝÓÜóÉ ±² Ó¿½÷ ±® Û²¬»®ò
DZ« ©·´´ ¿´± ²±¬·½» ¬¸» ¿¼¼·¬·±² ±º ´·²» ²«³¾»® ·² ¬¸» ¹«¬¬»® ±º
¬¸» »¼·¬±® ¿®»¿ò
ÍÏÔ ¾¿¬½¸ «°¼¿¬» ¿²¼ ¬®¿²¿½¬·±²
Þ¿¬½¸ «°¼¿¬»
̸» Ù®±±ª§ ͯ´ ½´¿ ²±© º»¿¬«®» ¾¿¬½¸ «°¼¿¬»ô ¬¸¿²µ ¬± ·¬ ²»©
©·¬¸Þ¿¬½¸ø÷ ³»¬¸±¼ô ¬¿µ·²¹ ¿ ½´±«®» ¿²¼ ¿ ¬¿¬»³»²¬
·²¬¿²½»æ
¯´ò©·¬¸Þ¿¬½¸ ¥ ¬³¬ óâ Å ô ô à ¥ ²¿³» óâþп«´þ þÖ±½¸»²þ
þÙ«·´´¿«³»þ ¬³¬ò¿¼¼Þ¿¬½¸ þ·²»®¬ ·²¬± ÐÛÎÍÑÒ ø²¿³»÷ ª¿´«»
øü²¿³»÷þ £ £
Ì®¿²¿½¬·±²
Í·³·´¿®´§ô ¬¸»®»ù ¿ ©·¬¸Ì®¿²¿½¬·±²ø÷ ³»¬¸±¼ ¿¼¼»¼ ¬± ͯ´ô ©¸·½¸
©±®µ ¿´± ©·¬¸ ¼¿¬¿»¬æ
¼»º °»®±² ã ¯´ò¼¿¬¿Í»¬ø ÷þ°»®±²þ ¯´ò©·¬¸Ì®¿²¿½¬·±² ¥
°»®±²ò¿¼¼ ²¿³»æ þп«´þ °»®±²ò¿¼¼ ²¿³»æ þÖ±½¸»²þ °»®±²ò¿¼¼
²¿³»æ þÙ«·´´¿«³»þ £
Getting Started Guide
Ù»¬¬·²¹ ͬ¿®¬»¼ Ù«·¼» Þ»¹·²²»® Ì«¬±®·¿´
Ì«¬±®·¿´ ï ó Ù»¬¬·²¹ ¬¿®¬»¼ Ì«¬±®·¿´ î ó ݱ¼» ¿ ¼¿¬¿ô ±® ½´±«®»
Ì«¬±®·¿´ í ó Ý´¿» ¿²¼ Ѿ¶»½¬ Ì«¬±®·¿´ ì ó λ¹«´¿® »¨°®»·±²
¾¿·½ Ì«¬±®·¿´ ë ó Ý¿°¬«®·²¹ ®»¹»¨ ¹®±«° Ì«¬±®·¿´ ê ó Ù®±±ª§
ÍÏÔ
Ü·ºº»®»²½» ¬± Ѭ¸»® Ô¿²¹«¿¹» Ü·ºº»®»²½» º®±³ Ö¿ª¿ Ü·ºº»®»²½»
º®±³ Ч¬¸±² Ü·ºº»®»²½» º®±³ Ϋ¾§
ܱ©²´±¿¼ Ú&