ETCH CO. PPT

8/8/2019 ETCH CO. PPT

1/46

1Cisco Uni fied App licat ion Env ironment Developers Conference 2008 2008 Cisco Systems, Inc. A ll rights reserved. Cisco Publ ic

Introduction to Etch

Scott Comer

Technical Leader

[email protected]


2/46


Welcome

Introduction to Etch

what it is

how to use it to build a network service

where it is going


3/46


What is a network service?

Messages and formats

Action: query or control; Event

Definitions / abstractions / rules

Players / authorization / transports


4/46


What is Etch?

Network service description language

Compiler

Runtime


5/46


Why Etch?

Language independence

Transport independence

Small and quick high performance

Symmetric


6/46


Relationship to Cisco Unified ApplicationEnvironment

Application environment is a federation of services

Formalized APIs

Programmable and extensible

Enhances the Developer Experience


7/46


Demos

Hello World


8/46


HelloWorld Example Overview


9/46


HelloWorld C# Demo

Create etch interface

Generate server and client code

Implement the hello message in the server

Call the hello message from the client

Build the server and client

Run the server and client


10/46


Sequence Diagram

Client Listener Server

Listen


11/46


Sequence Diagram


Connect

Listen


12/46


Sequence Diagram


Create ServerSession

Connect

Listen


13/46


Sequence Diagram



Connect

Listen

Sends Hello

To Server


14/46


Sequence Diagram



Disconnect

Connect

Listen

Sends HelloTo Server


15/46


Summary Hello World C# Demo

Etch generated most of code.

Generated code does all of the plumbing.

Developer only needs to be concerned with

implementing and using the interfaces.

Less than 5 minutes to build a simple client / serverapplication.


16/46


HelloWorld Java Demo

Show using Etch in Eclipse

Start with existing demo

Add client callback


17/46


Summary Hello World Demo

Java has similar experience to C#

Message sending looks just like procedure calls

Generated codes may be easily integrated


18/46


Etch Language


19/46


Etch Language

Messages

int add( int x, int y )

Native types

boolean, byte, short, int, long, float, double, string, object, List,Map, Set, arrays of those things

Structured data types

struct Point( double x, double y, double z )

External data types@Extern( java, com.company.User, )

extern User


20/46


Etch Language, part 2

Constants

const int ZERO = 0

Enumerations

enum PrimaryColor ( RED, GREEN, BLUE )

Exceptions

exception LoginFailed( int code, string msg )


21/46



Attributes

@Direction( which ) server, client, both

@Oneway

@Timeout( millis )

@Authorize( method, args )


22/46



Formal Comments

/*** Adds two numbers together.

* @param x the first number.* @param y the second number.

* @return the sum of the arguments.*/

int add( int x, int y )


23/46



Mixins

service Foo

{

mixin Barmixin Baz

}


24/46


Etch Language Example

module com.acme

service GeoFun

{

const double DEFAULT_HOW_FAR = 10 // miles

const int DEFAULT_NUM_LANDMARKS = 20

struct Point( double latitude, double longitude )

struct Landmark( Point where, string description )

void addLandmark( Landmark landmark )

void removeLandmark( Landmark landmark )

Landmark[] searchLandmarks( Point where, double how_far,

int count )

}


25/46


Nitty Gritty Details

Compiler, architecture


26/46


Etch Compiler

Written in Java (runs anywhere)

Uses Templates (easier to port)

Bindings (java, csharp, )


27/46


Etch Process

Etch Source EtchCompiler

Interface

StubRemote

ValueFactory

Helper

Base

Main Impl


28/46


Etch Inheritance

Interface

Remote Base

Impl


29/46


Etch Architecture

Stub

Remote

Transport

Impl

Main

Stub

RemoteTransport

Impl

Main


30/46


Etch Architecture

Stub

Remote

Transport

Impl

Main

Stub

RemoteTransport

Impl

Main


31/46


Etch Architecture

Stub

Remote

Transport

Impl

Main

Stub

RemoteTransport

Impl

Main


32/46


Etch Architecture

Stub

Remote

Transport

Impl

Main

Stub

RemoteTransport

Impl

Main


33/46


Etch Architecture

Stub

Remote

Transport

Impl

Main

Stub

RemoteTransport

Impl

Main


34/46


Runtime

Message model

Compiler support

Transport

Utilities


35/46


MessageModel

Representation (type, fields & values)

Meta data

Generated code is transport independent


36/46


Transport

URI specification

Manages session

Moves messages

Message format is generic or transport specific

(binary, xml, soap, )


37/46


Transport, part 2

Transport services and properties

Authentication, session, logging, rate control, filtering

ProtocolsNow: TCP, TLS

Planned: JSON, UDP, AES, SOAP

Extensible

JMS, REST,


38/46


Transport, part 3

ValueFactory

StubRemote

Messagizer

Mailbox

Manager

Packetizer

Stream

Security

Filter Chain

auth

log

session

keep alive


39/46


More Demos

DistributedMap


40/46


Distributed Map Demo

Provides access to a shared Map

Add notification when values change

Example of session management


41/46


Roadmap

JSON, Python, C, Ruby bindings

More transports and transport modes

Web Services Gateway

Better Integration with IDEs, Maven


42/46


Etch will be Open Source!!!

is


43/46


Where from here?

Distribution:

http://developer.cisco.com/web/cuae/etch

Source

https://etchproj.svn.sourceforge.net


44/46


Summary

Etch is a powerful tool that formalizes APIs used toaccess and extend Cisco Unified ApplicationEnvironment

Etch automates many tedious and distracting tasks

Etch may be used in your own projects, and embedded

in your own systems.


45/46


Q and A


46/46

Documents

ETCH CO. PPT