Foomatik blog

Tech quickies: How to restore PowerPC support in Xcode 3.2.6

2011-07-16T11:36:00.012+02:00

Starting from Xcode 3.2.6 Apple dropped support for PPC architecture. What is even worse there's a big chance that you won't event notice it - I didn't and it caused releasing Que 1.3 build without PPC architecture.

Fortunately there is still easy way to restore PowerPC builds in Xcode. To do that you just need to change settings for your build target (right click on target and choose "Get Info"). Your current settings (without PPC) should look like:

Click on current architecture (the one marked with red rectangle), popup menu will appear - choose "Other..." option, following sheet should appear:

Now you need to edit architecture list, Que app supports i386 and PPC so for my case I deleted $(ARCHS_STANDARD_32_64_BIT) and added two other architectures:

Click OK and you should be set up.

You can easily test if it works for you - make a new build and check if output binary contains selected architecture - to do that just use file program (Unix command line tool for determining type of FILEs):

mymachine:~ wojtek$ file ~/que/trunk/build/Release/Que.app/Contents/MacOS/Que
/Users/wojtek/que/trunk/build/Release/Que.app/Contents/MacOS/Que: Mach-O universal binary with 2 architectures
/Users/wojtek/que/trunk/build/Release/Que.app/Contents/MacOS/Que (for architecture ppc7400): Mach-O executable ppc
/Users/wojtek/que/trunk/build/Release/Que.app/Contents/MacOS/Que (for architecture i386): Mach-O executable i386

As you can see everything worked fine and Que binary has 2 architectures. That's it.

Que 1.3.1 is out.

2011-07-05T21:47:00.007+02:00

This release is mainly quick fix for missing PowerPC architecture - Apple dropped official support for this architecture in Xcode starting from version 3.2.6 - I didn't event notice that 1.3 build wasn't prepared PowerPC.

Fortunately there is easy way to make universal build in Xcode 3.2.6, which I will write about in Tech Quickies soon.

Update: There is new blog entry on restoring PowerPC architecture in Xcode 3.2.6.

Download Que 1.3.1 here.

Que 1.3 and Online dictionaries released!

2011-06-29T09:03:00.004+02:00

New version of Que goes live. This long lasting phase of development and testing brings brand new category of features called Online dictionaries. Its main purpose is to provide possibility to share dictionaries via internet. Here's what you can do with it:

browse list of dictionaries
download dictionary you are interested in
upload your dictionary

All features are build in application and are extremally easy to use. Here's example window with dictionary list:

Online dictionaries is all about community. It means that it's content is provided by and for users. It's free and to use key features you'll need to follow simple registration process (only nickname, e-mail address and password is required). Once you confirm your e-mail address you are all set up to use all new exciting features.

As usual, new version of Que also brings some usability improvements which hopefully will make your Que experience even better.

Are you already Que user? Do you have some dictionaries filled in? Contribute to Que project and upload your dictionaries.

Requirements

Mac OS X 10.5 or Mac OS X 10.6
Intel or PowerPC processor

Feedback

As usual comments, ideas, suggestions are welcome. Contact me at wojtek.janiszewski@gmail.com.

Download

Download Que 1.3 here

Project home page

Visit que.foomatik.com

Tech quickies: bulk mail, decent hyperlink matters!

2011-04-18T20:11:00.002+02:00

Sending e-mails from your application can be tricky. Todays spam filters are doing really great job sorting out junk e-mails, but they also can be a problem for legit web creators. There are some resources on the internet about creating proper newsletters, the first thing you want to read is probably Bulk Senders Guidelines by Google.

Recently I bumped into problem registration e-mails were classified as spam, even with signed DKIM and all other juicy stuff. Long story short, the registration e-mail had registration confirmation hyperlink in it and obviously it was too long, ie:

http://host.tld/registration/confirmRegistration.do?id=123&confirmationCode=FJK947MNHL89BHGFJHMMNG

The solution was to cut link to shorter form, as ie:

http://host.tld/cr.do?id=123&cc=FJK947MNHL89BHGFJHMMNG

Happy 1st birthday Que!

2011-03-25T21:57:00.003+01:00

I'm proud to announce that exactly one year ago first version of Que was released. This is my first such long term, non profit and personal project. Hope it will last for many years!

This is great occasion to show some numbers!

over 1 year of development
2 different hosting providers used
$3 donation received (thanks!)
5 versions released (1.0, 1.1, 1.1.1, 1.2, 1.2.1)
almost 6 language versions (French in progress)
11 hours spent on website recovery after first provider server crash
$54 spent on hosting providers, domain
119 returning users (10 and more application launches)
127 SVN commits
5754 que.foomatik.com visits
9523 lines of Objective-C code (without header files)
9823 downloads (+ downloads hosted outside foomatik.com)
13489 registered application launches (+ launches without internet access or without application update check)
infinite amount of fun!

Thanks for staying with me!

Russian and Ukrainian translations for Que, 1.2.1 release is out.

2011-02-27T21:23:00.004+01:00

Que 1.2.1 version is out! It's just quick release which brings Russian and Ukrainian translations (thanks to Alexander Zhurovich and Illarion Khapersky). Currently I'm actively involved in development of stunning features, scheduled for 1.3 release, stay tuned for details.

Download Que 1.2.1 here

Que 1.2 is out!

2011-01-09T17:27:00.005+01:00

Que 1.2 is ready for downloads!

This release brings, in general, usability improvements. Now you can use word inspector to show and edit word properties, as well as see it's usages in files. Furthermore I've added new word property - comments - which will be useful in various cases, ie. commenting on word prononciation.

Some of you will be pleased with possibility to hide unused dictionary columns (if you don't need "date added" for example). From now on you can also easily see which words doesn't belong to any file (helpful for missing entries), just use menu "Dictionary" on the left side.

There are also some more minor usability enhancements, just check them out by yourself!

What are the plans for now? Little break from coding and focus on planning new, exciting features which I hope will bring Que to the new level! I also didn't miss Apple releasing Mac App Store, which I'm thinking of too. Stay tuned.

Requirements

Mac OS X 10.5 or Mac OS X 10.6
Intel or PowerPC processor

Feedback

As usual comments, ideas, suggestions are welcome. Contact me at wojtek.janiszewski@gmail.com.

Download

Download Que 1.2 here

Project home page

Visit que.foomatik.com

Que 1.2 development is almost over!

2011-01-01T16:08:00.011+01:00

I'm really excited to tell you that major features scheduled for 1.2 release of Que are finished! Now it's time for project to enter tests phase which means you can expect this new peace of software to try really soon.

Major changes:

Inspector added, which simplifies working with word properties (see attached screenshot).
New word property added - comments.
Now you can choose which columns to display in dictionary view.
Navigation enhancements - special files: All words, Words without files.
Few Quiz usability enhancements.

Most of above mentioned changes are ideas which came out from Que users. I'd like to thank you all for this great response I've received since releasing 1.1!

Day in Tatry mountains (Dzień w Tatrach)

2010-12-06T20:39:00.006+01:00

I prefer not to write about my non-tech life on a tech blog (yes, I have some non-tech life and I quite enjoy it!:)) but I have to give you little background on project origin.

Recently I became sort of mountain geek person, which manifests ie. in various mountain journeys and hikes. Unfortunately most of my time I spend in the-flattest-part-of-Poland so usually I can admire mountains only via static webcams.

- Well here's some space for optimization - says the other geek in me, the Computer Geek - Instead of visiting this webcam couple times a day why not to create Unix script to capture webcam frames and make video of it? It could upload it on Youtube, generate HTML and do it every day. I bet other people would be also pleased with daily Tatry panoramas. And after a year you would have this huge archive!

- Well... let's code! Uhm, I mean, you code. - agreed Mountain Geek.

Thanks to powerful *nix scripting and command line capabilities it was possible for me to complete this weekend project easily delivering quite elegant solution. Here's what I used:

Bash script (shame on me?)
cron
wget
ffmpeg
youtube-upload (uses gdata-python-client library)
... and other basic command line tools

Script output can be found on project page, updated daily.

Here's the first (official!) video captured and published. Enjoy!

Environment hell

2010-09-30T20:22:00.011+02:00

Long time ago, when there was no Internet, software was only distributed physically and run locally on users machines, developers had to cope with various possible runtime environments. Multitude of operating systems versions, hardware and installed libraries provided a little hell for a programmer to prepare his software to run everywhere. Not to mention performing tests on major combinations of components (not to mention all combinations, because nearly impossible). The truth is those day aren’t over which I (unfortunately) had to find out recently, while testing Que. It started with that I found out that my little piece of software behaved little bit different on various Mac OS X versions. Basically Que supports two latest major OS X editions (10.5 and 10.6) which I test on and I assumed every 10.5.x and 10.6.x will be OK. The biggest surprise for me was when I booted 10.5.6, which behaved different to 10.5.8.

“So what, am I supposed to check every 10.5 and 10.6 release and redo all test scenarios?” I said to myself? Not to mention about installing, upgrading, deleting various OS X editions. Not to mention that I own only one Mac here...
Then I just immediately recalled the beauty of thin client idea, web apps and all modern stuff which is going on right now. One code, run on remote machines and results returned as HTMLs, displayed the same way everywhere. Only one environment for your code to run and test. So I started to miss web development again.

But it’s not so great as it sounds and the story about environment hell returns. Recently while doing some web related development work I started to struggle with problems with displaying UI components on various web browsers. Does it sound familiar to you? Bet you heard about programmers frustrations with weird Internet Explorer behaviors. But that’s not only the IE; we have couple more modern web browsers which we should provide support for: Firefox, Opera, Chrome, Safari... I didn’t realize about those subtle differences which can make hell out of your work day.

So again, check your code on all browsers again, test them all... but hey, wait there’s also Firefox 3.4.7f which can’t display this Javascript construction... and hey, in IE8 and older you cannot use opacity in CSS... and man, this Chrome sends some weird HTTP header, which cause application server to respond with some exotic content type, which your code doesn’t treat as a text, but something it cannot parse, so appears as a bug instead.

Well, why I am actually complaining? I should remember that it passed only 40 years since the UNIX era started and IT is still a child, a spoiled and hyperactive teenager who thinks is grownup; it's developing fast, strong but still making so many mistakes.

Dutch translation for Que, 1.1.1 release is out.

2010-08-08T17:12:00.003+02:00

Que 1.1.1 version is out! It's just quick release which brings new, Dutch translation (thanks to Eddy Groen). New features are scheduled for version 1.2.

Download Que 1.1.1 here

Que 1.1 released!

2010-07-22T21:57:00.016+02:00

At least, next version of Que is available. It introduces new great features and I'm all excited to start using it for my own language learning purposes.

The most important changes are:
- Advanced word grouping, you can create files and folders and organize them into hierarchical structure
- Import/export features, comma separated values (CSV) format is supported

Que 1.1 also brings many other little enhancements, UI candies and I strongly recommend you to test it by your own.

Thank you for being patient, have fun!

Requirements

Mac OS X 10.5 or Mac OS X 10.6
Intel or PowerPC processor

Feedback

As usual comments, ideas, suggestions are welcome. Contact me at wojtek.janiszewski@gmail.com.

Download

Download Que 1.1 here

Project home page

Visit que.foomatik.com

Tech quickies: Deselecting row in NSOutlineView with Highlight set to Source List

2010-06-20T20:52:00.007+02:00

I am starting new series of posts on my tech blog: Tech quickies. The idea is to publish short articles about features of technologies I am working on, issues regarding using them or anything which can be interesting from programmers point of view. But to the point.

Problem

Recently while developing Que 1.1 I bumped into following problem: I couldn't deselect rows in my NSOutlineView just by clicking in the area with no row visible. It appears that NSOutlineView with Highlight attribute set to Source List (Interface Builder) cannot do that - the only way to unselect row is to click it with your mouse while holding down command key - pretty strange and definitely not intuitive.

Solution

I couldn't find any solution on the internet but wrote few lines of code which perfectly do what is missing. What's the approach? We want to intercept mouse event and check if it points to any row (do what is normally done) or just onto empty space (unselect all). Pretty simple, as well as code which does the trick. The first thing you need to do is to create new class which should inherit from NSOutlineView. The second and the last is to override following method and put some really simple logic in:

- (void)mouseDown:(NSEvent *)theEvent {
NSPoint point = [self convertPoint:[theEvent locationInWindow] fromView:nil];
int row = [self rowAtPoint:point];
if (row >= 0) {
[super mouseDown:theEvent];
} else {
[self deselectAll:nil];
}
}

That's it, enjoy!

Que 1.1 almost ready!

2010-06-14T21:19:00.004+02:00

Que is alive and all major features for 1.1 release are finished! I've spent decent amount of time on import/export features lately, made it easy as possible and fun to use, think you will like it - it's just drag and drop! I also didn't forget about few UI candies here and there.

Now it's time for Que to enter last phase: polishing & testing. There is also some space to add few minor features, but not sure about that. First of all I'd like just to make sure that everything is just right and I didn't forget anything.

What's new:

Que remembers position size and location.
Advanced word grouping - hierarchical files and folders.
Improved search access by CMD + F shortcut.
Importing items from CSV (comma separated values) files.
Exporting items to CSV files.
Dragging words, files and folders out of the application to Finder will export items.
Dragging files from Finder to application will import items.
Creating new files by dragging words to group view.
Facultative words can be configured to ignored or not while taking quiz.
Lots of little UI improvements.
All the things I don't remember :)

I'm all excited about incoming release, it's always fun to release new software!

Que 1.1 preview: User Interface

2010-05-09T23:19:00.012+02:00

I’d like to show you some of user interface changes which are going to be available in the next Que release, version 1.1.

Grouping
The biggest UI change is words grouping. Those of you who used Que 1.0 knows that it is only available to group words without any hierarchy. Que 1.1 introduces new model, which allows you to create folders and files. Files are meant to store words and purpose of folders is storing objects like files or other folders. Please take a quick look at screenshot below to see an example:

As you see you can organize your files and folders into nice structures, which can help you keeping your words in order.

Drag and drop
You can simply rearrange your folders structure. Just drag some files and/or folders and drop them on another folder.

If you drag portion of words into groups view, a green file named “New file” will be shown (as in the picture). New file will be created only if you drop dragged words on this new green group. What a simple way to create new groups, isn’t it?

Miscellaneous
There are also some minor button rearrangements on the application toolbar, few little touches to give the application fresh look.

Feedback
If you want to read more about Que 1.1 improvements please stay tuned. If you have any suggestions or ideas for new features or how to improve existing ones I would be glad to hear from you.

Que 1.1 development in progress!

2010-04-13T22:41:00.008+02:00

Development of the new version of Que (1.1) started! I have many ideas for new features which I would like to see in the next versions, but obviously cannot implement them at once. The list is big and I have to pick only the most important things and unfortunately the decision is not so obvious.

What you can expect in Que 1.1?
One of the highest priorities for Que development is neat and highly usable user interface. You can expect improvements in UI which will come gradually in every release. What’s the big deal about it? My main concert about user experience comes from impressions taken from many other Mac apps. I just want Que to match (or even exceed) the standard.

Some users were interested in exporting and importing features. Lets not get into the reasons why I didn’t include those features in Que 1.0, I would like to assure you that it will appear in Que 1.1. I cannot tell right now what formats are going to be supported, I’m still doing some research to find most popular and universal ones.

There would be probably some extra features and I don’t want to give away all secrets right now. I am also open to users request, if you have any idea for Que development feel free to write about it (comment on post, or e-mail - preferred).

When it will be released?
When it will be done, I can't promise any date mainly because it’s a side project, I cannot work on it full time. The second reason is that I pay more attention to quality than deadlines - it better to be little late than incomplete. I can only assure that you won’t wait long.

Que for Mac OS X: memorizing and recalling words from foreign languages made simple!

2010-03-25T09:00:00.025+01:00

I am happy to announce first version of my new application, Mac OS X vocabulary learning tool. What is the idea?

It’s really easy to memorize and recall words just when you start learning new language, but imagine how hard could it be to recall words which you learned months ago? The solution is to constantly train and recall all words you learned. Que allows you to store words from various languages and tests your knowledge, which if done systematically will make learning and recalling vocabulary easier.

Que has a friendly, lightweight user interface with English and Polish translations available. It focuses on key features and does them well. To start add dictionary and specify facultative words for every language. You can easily add synonyms for words and translation using commas. Groups words into categories (example: lessons) via drag and drop. Take a quiz to test your knowledge: chose from seven different test categories like "New words", "Difficult words", specific lessons and more. Review your results and repeat wrong answers.

Requirements

Mac OS X 10.5 or Mac OS X 10.6
Intel or PowerPC processor

Download

Download Que 1.0 here

Project home page

Visit que.foomatik.com

Apache Tuscany SCA Java 1.6 binary modules for Erlang binding

2010-03-18T12:59:00.008+01:00

As far as you may (or not) know, Erlang binding is available only in source distribution. I mentioned it previously and it means you have to build Tuscany by yourself, which can be time consuming. Not anymore! If you want to just play with Erlang binding, you can use binaries from official maven repository:

http://repo1.maven.org/maven2//org/apache/tuscany/sca/tuscany-binding-erlang/1.6/

http://repo1.maven.org/maven2//org/apache/tuscany/sca/tuscany-binding-erlang-runtime/1.6/

It's really simple to enable Erlang binding in your maven project, you should add following dependencies:

<dependency>
 <groupId>org.apache.tuscany.sca</groupId>
 <artifactId>tuscany-binding-erlang</artifactId>
 <version>1.6</version>
</dependency>

and:

<dependency>
 <groupId>org.apache.tuscany.sca</groupId>
 <artifactId>tuscany-binding-erlang-runtime</artifactId>
 <version>1.6</version>
</dependency>

Remember to include other dependencies required to run Tuscany environment.

Erlang binding released in Apache Tuscany SCA Java 1.6 (February 2010)

2010-02-24T11:37:00.006+01:00

I'm little late but still proud to announce Apache Tuscany SCA Java 1.6, which is first release containing my latest contribution to Apache Tuscany, Erlang binding. Note that Erlang binding is available only in source distribution. Enjoy!

Source distribution, as well as binaries are available under official Apache Tuscany download page:

http://tuscany.apache.org/sca-java-1x-releases.html

Erlang binding documentation page can be found under:

http://tuscany.apache.org/sca-java-bindingerlang.html

Due to problems with build process for Erlang binding we had to throw it away from binary distribution. The main problem was that Erlang binding module JUnit tests, as well as samples requires Erlang distribution installed, which cannot be smoothly automatized (it requires compiling C/C++ code, which requires compilers and tools...).

Finished Erlang binding extension for Apache Tuscany

2009-06-17T17:39:00.004+02:00

Hi folks,
I'd like to announce that I've finished coding Erlang extension for Apache Tuscany SCA Java (see previous announcements).

The code is currently committed to 1.x source line and hopefully will appear in official Apache Tuscany distribution in the future. Those of you who would like to try it right now must compile it from the 1.x source manually.

Please refer to official documentation for features and usage instructions.

Whole Erlang related work is part of my master thesis (it looks like I'm going to graduate shortly!) which is generally about extending SCA runtime, Apache Tuscany. I feel really satisfied with work I did - it's great to be able to fulfil university responsibilities with something which could be helpful for others. I'm also glad for having another possibility to contribute to open source community (and hope there will be more opportunities).

I'm really curious about usefulness of this extension - I'm looking forward for hearing users opinions, it's really interesting for me how you are going to use it and which features would be best/worst for your scenarios.

Working on Erlang binding extension for Apache Tuscany

2009-03-24T22:08:00.003+01:00

As I've announced before, I decided to continue work on Erlang binding. In fact I've started one month ago, and with few days per week I managed to complete following features:

Client RPC (invoking Erlang functions)
Sending Erlang messages to remote Erlang mboxes by executing methods backed by Erlang reference bindings
Service RPC (exposing SCA components operations as Erlang functions)
Exposing SCA components operations as Erlang message boxes
Erlang cookies (which are something like passwords which value should match on both communicating nodes)
Timeouts for services, which allows user to define acceptable time between client connects and sends it's messages (this feature allows ie. to prevent stealing thread)
Timeouts for references, which allows to define acceptable response time

I'm still thinking about process linking implementation, which doesn't appear to fit smoothly into SCA model. It's not critical feature, but still worth implementing.

What MSDN knows about Linux?

2009-02-03T21:52:00.008+01:00

I'm back after a little break, which was caused by some university responsibilities. I really had much work at the end of winter semester, I made one little and one big project, which I'm hoping to write about in the future. I'm also kinda confused about future of this blog - after I've released Qub3DS I'm noticing many visitors outside Poland (and I'm hoping you are not those which left my blog opened on browsers tab ;p) , so I'd like to give them chance to understand this content. So this is why I'm writing again in English.

But to the point...

Just type "Linux" query to the MSDN search engine. First result can make you laught, especially if you are some wicket computer geek ;). It may look like a some easter egg, but it's still there for few years.

Qub3DS for Nintendo DS - homebrew game

2008-12-14T23:55:00.022+01:00

Qub3DS is a Nintendo DS port of Qub3D, a tetris like mini-game from Grand Theft Auto IV.

I've finally managed to release first version. I haven't been coding games for ages so it was fun and little break from doing enterprise and Java stuff. I don't have much experience in game programming, this is actually first game which I'm releasing to public so please be patient. ;)

It uses only one screen, no touch screen input, it's controlled simply by D-Pad, A and Start. If you weren't playing the original Qub3D game you'll have to learn intuitively those non standard game rules. Game looks like:

Download

Download Qub3DS 1.0.

Inspiration

I decided to create game based on original Qub3D tetris like game, which appears as mini-game in GTA IV. I wanted to rip all original rules and port them to DS (so maybe *inspiration* is not appropriate word?)

Reality

What was successfully ported:

original block moving rules (however it looks that Rockstar guys didn't spent too much time on inventing them, so some oddities could be found)
original block pattern matching (which means that blocks dissapears in the same fashion as in original game)
saving hi scores
other stuff which I can't remember right now?

What's different:

audio/video obviously differs
score calculation rules weren't clear enough to me so I've introduced my own score system
other things which I didn't noticed?

Future
There's always more to do:

gathering and responding to users (if there will be any ;)) feedback
improving (graphics, sounds, game screens)
bugfixing

Installing, running

To run this game simply copy it to your DS hombrew hardware and then execute. There's no need to use DLDI patcher, but doing this will allow you to save your high scores.
Note that game will create a little file on your device when using DLDI patch. This files name is "qub3scr" and it stores your highscores.

Media

Here's some Qub3DS running on real Nintendo DS machine:

And here's some gameplay from original version:

Feedback?
Please let me know what do you think about Qub3DS.

Enjoy!

Integracja Erlanga z SCA (Apache Tuscany)

2008-11-22T01:16:00.004+01:00

Nie będę ukrywał, że lubie egzotyczne tematy. Jeszcze dwa tygodnie temu o Erlangu nie miałem bladago pojęcia, postanowiłem jednak przymierzyć się do integracji tegoż z Javową implementacją SCA, którą jest Apache Tuscany (;)). W wyniku moich krótkich poszukiwań powstał dokument, do którego gorąco zapraszam. Być może znajdzie się ktoś, kto patrząc doświadczonym okiem "Erlangowca" wskaże mi to i owo?

Certified Google Summer of Code 2008 participant

2008-10-23T15:29:00.006+02:00

Dwa dni temu listonosz zaskoczył mnie przesyłką wprost z Mountain View, CA, która to zawierała długo wyczekiwany certyfikat::

W przesyłce znalazł się również tematyczny t-shirt. Tymczasem w najbliższej przyszłości czeka mnie ponowne zanurzenie w rozwój Apache Tuscany, wybór projektu na Google Summer of Code 2009 oraz schrupanie zakurzonego "Beautiful Code" (książka ta została sprezentowana każdemu studentowi który zakwalifikował się do GSoC2008).

Przy okazji: w weekend „zaliczyłem” Bieszczady – foto raport do obejrzenia tutaj.

Google Summer of Code 2008 zakończone!

2008-10-11T20:18:00.008+02:00

Mam przyjemność ogłosić, iż tegoroczne Google Summer of Code 2008 ukończyłem z sukcesem. Wg. danych przedstawionych przez Google 83% z 1125 uczestników programu ukończyło swoje projekty z wynikiem pozytywnym. Każdy z uczestników został zobowiązany do wysłania kodu powstałego w czasie trwania projektu. Źódła projektów Apache Software Foundation znajdują się w repozytorium, natomiast mój projekt można pobrać tutaj.

Co pozatym? Dwa tygodnie temu wróciłem z długo wyczekiwanych wakacji, zapraszam więc do obejrzenia galerii z wyprawy.

Ostatni dzień Google Summer of Code 2008

2008-08-18T14:42:00.006+02:00

Na dzisiaj przypada ostatni dzień GSoC 2008. W związku z tym chciałbym opublikować listę rzeczy które zostały ukończone w trakcie programu.

1. Co zostało zrobione w pierwszej fazie? (26 maj - 07 lipiec)

ogólnie rozszerzenie binding.corba
rozszerzenia hostujące (host-corba, host-corba-jdk)
testy JUnit dla poszczególnych modułów
testy integracyjne

2. Co zostało zrobione w drugiej fazie? (08 lipiec - 18 sierpień)

refaktoring modułów host-corba, host-corba-jdk
utworzenie modułu host-corba-jee
dodanie mapowania operacji CORBA do metod Java
domyślne wiązanie sca (binding.sca) po protokole CORBA (z użyciem binding.corba)
utworzenie modułu host-corba-jse-tns rozszerzającego host-corba-jse poprzez autostart serwera nazw CORBA
dodanie obsługi tablic i unii
dokumentacja wiązania CORBA w postaci podstrony WWW projektu Apache Tuscany
testy JUnit dla poszczególnych modułów
testy integracyjne

3. Co nie zostało zrobione?

rozszerzenie dla wsparcia języka IDL (planowane pierwotnie, jednak wyparte przez inne zadania)

Już niedługo po zakończeniu programu studenci oraz mentorzy będą mogli ponownie wypełnić stosowny formularz, tym razem tzw. "final evaluations". Koniec trwania programu nie oznacza dla mnie jednocześnie końca przygody z Apache Tuscany. Wręcz przeciwnie - razem z dołączeniem do grona commiterów chciałbym dalej rozwijać projekt, a swój wkład w ramach możliwości publikować w formie pracy magisterskiej. Stay tuned.

Apache Tuscany 1.3 wydane!

2008-08-09T14:26:00.003+02:00

5 sierpnia 2008 zespół Apache Tuscany ogłosił kolejną wersję implementacji SCA. Zapraszam na stronę wydania.

"Wojtek Janiszewski voted as a Tuscany committer"

2008-07-31T12:34:00.005+02:00

Tytuł tego wpisu to jednocześnie tytuł maila który pojawił się 29 lipca na deweloperskiej liście mailingowej projektu Apache Tuscany. Zostałem więc oficjalnie przyjęty do grona commiterów! Bardzo miła nowina. Emocje wprawdzie zdążyły opaść, bo pierwsze nieoficjalne sygnały zaczęły docierać do mnie już dwa tygodnie wcześniej, jednak mimo wszystko chyba do dziś nie widzę pełnego obrazu nowych możliwości, jak i obowiązków. Tak czy inaczej, ciekawe dokąd jeszcze zaprowadzi mnie udział w tegorocznym Google Summer of Code?

Kim jest commiter? Krótko mówiąc jest osobą posiadająca prawo zapisu do repozytorium kodu hostowanego przez Apache Software Foundation. Będąc wcześniej kontrybutorem (contributor) aby dodać kolejny kawałek kodu do repozytorium musiałem uploadować łatkę do JIRY oraz czekać na weryfikację i commit któregoś z commiterów. Teraz oprócz "szaleństwa po svn'ie" mam kilka dodatkowych przywilejów - dla dociekliwych polecam FAQ i Guide for new commiters.

Jaki status? Google Summer of Code mid-term evaluation!

2008-07-16T00:13:00.012+02:00

Stało się! 14 lipca o godzinie 23 "czasu polskiego" upłynął* termin składania mid-term evaluations**. Co to oznacza? Że wreszcie oficjalna informacja o kontynuowaniu projektu stała się dostępna. Zdziwiłem się jednak (a i pewnie nie tylko ja) że do takiej informacji w prosty sposób się nie dostanę. I to ani przez web-aplikację Google'a, ani też e-maila z automatu nie dostałem (jak w przypadku potwierdzenia o zakwalifikowaniu się do GSoC). Każdy dostał polecenie spytać swojego mentora.

Co mój mentor na to? Właśnie wysłałem mu maila z zapytaniem, ale to już chyba nieistotne, bo ponad tydzień temu gratulował mi na liście mailingowej z okazji dostarczenia pierwszej funkcjonalności. Ale cóż, wszyscy zawsze lubimy i czekamy tylko na te oficjalne informacje.

Update: otrzymałem odpowiedź od mentora i tak jak wcześniej podejrzewałem, wszystko jest w porządku. Ba, po treści e-maila wnioskuję nawet, że wyniki mojej pracy przewyższyły oczekiwania. Nice.

* Napisałem upłynął - tak było w teorii. W praktyce jeszcze przez niecałe dwie godziny można było edytować formatkę. Nie wiem jeszcze do końca jak to działa, ale ma na pewno związek z architekturą aplikacji Google'a - w innych rejonach geograficznych możliwość edycji została wyłączona o czasie.

** mid-term evaluation - ocena projektu na półmetku. Wypełniana przy pomocy formularza na stronach odnośnie Google Summer of Code przez studenta jak i jego mentora. Od mentora zależy, czy student będzie mógł dalej uczestniczyć w programie. No i oczywiście czy dostanie pieniądze. Od studenta nie zależy nic ;) - taki feedback.

Google Summer of Code 2008 - wrażenia z pierwszej linii

2008-06-26T14:20:00.024+02:00

Ostatnio na blogu jest mało technicznie, także i ten wpis będzie bardziej "miękki". Jako że dziś mija miesiąc od rozpoczęcia pierwszego etapu programowania w Google Summer of Code postanowiłem podzielić się swoimi wrażeniami.

Harmonogram GSoC można znaleźć tutaj i nie wdając się w zbędne szczegóły - programowanie odbywa się w dwóch fazach:

pierwsza (26 maja - 6 lipca)
druga (14 lipca - 17 sierpnia)

Po zakończeniu każdej z nich, mentorzy oraz studenci oceniają wzajemnie swoją pracę, po czym jeżeli ocena jest pozytywna to student otrzymuje ratę stypendium.

Zbliżam się więc nieuchronnie do końca pierwszej fazy i nie zapeszając, myślę że wszystko pójdzie zgodnie z planem. Więcej szczegółów odnośnie postępów można znaleźć na wiki oraz w archiwum listy mailingowej dev@tuscany.apache.org.

Jakie są moje osobiste wrażenia z uczestnictwa w Google Summer of Code 2008? Część z nich będzie dotyczyć nie tyle co GSoC, a pracy zdalnej nad projektem open-source'owym.

komunikacja w projekcie - członkowie projektu są pomocni, aczkolwiek nic chyba nie zastąpi rozmowy "na żywo". Ponadto mimo średnio-zaawansowanej znajomości języka angielskiego nadal nie jest moim język natywnym. Ma to też swoje plusy - wypowiedzi czytane są staranniej, a charakter komunikacji, że tak się wyrażę, asynchroniczny, sprawia że odpowiedzi są (bywają;)) przemyślane.
zajęcia poza (studia) - ideą GSoC jest wdrażanie studentów w rozwój oprogramowania open-source'owego w wakacje, wtedy gdy nie mają obowiązków związanych ze szkołą. W praktyce okazuje się, że to właściwie Amerykanie kończą semestr letni z końcem maja (moment rozpoczęcia kodowania w GSoC), a studenci innych krajów (jak np. PL) muszą połączyć start projektu z najbardziej intensywnym okresem na studiach - przygotowaniami do sesji oraz sesją letnią (założę się, że niektórzy mogą być sceptyczni co do ostatniego;)). Ja już szczęśliwie mam prawie wszystko pchnięte do przodu, ale mimo wszystko będę pamiętał czerwiec jako jeden z bardziej intensywnych miesięcy.
praca w domu - z jednej strony fajnie, bo nie trzeba tracić czasu na dojazdy i wszystko niby jest pod ręką, z drugiej kwestia mobilizacji, gospodynie-sąsiadki ubijające mięso na schabowego (zainspirowany zdarzeniem mającym akurat miejsce), ekipy remontowe oraz bandy dzieciaków pod oknem (Dzień Świra?:)).
elastyczny czas pracy - tak, to jest plus. Tuż po rozpoczęciu doceniłem, że mogę spokojnie posiedzieć dłużej w nocy, nie martwiąc się że nie wstanę do pracy. W praktyce okazuje się czasem, że potrzebując pomocy od mentora (mieszkającego w San Francisco) muszę dostosować się do jego godzin pracy - wtedy to już ciężko nazwać to elastycznym czasem pracy.

Tak czy inaczej, odczucia mam pozytywne, zwłaszcza że postępy są odczuwalne. Optymistycznie patrzę więc w przyszłość i wiąże nadzieje z nadchodzącymi dwoma miesiącami pracy przy Apache Tuscany.

Apache Tuscany wyszedł z inkubatora!

2008-06-18T10:08:00.005+02:00

To już trzeci z rzędu odgrzewany kotlet – 21 maja 2008 Apache Tuscany został ogłoszony oficjalnym projektem Apache Software Foundation.

Dlaczego postanowiłem dziś o tym napisać? Ano dlatego, że wczoraj projekt przeszedł małe trzęsienie ziemi: zmiany w lokalizacji repozytorium kodu, zmiany w adresach list mailingowych, zmianę domeny na http://tuscany.apache.org/ (na http://www.apache.org/ nie ma jeszcze linka). Aż miło patrzeć na rozwój projektu, a śledzę go prawie 2 miesiące.

Ciekawostka: do Google Summer of Code 2008 zostały zakwalifikowane 32 tematy prac, w obrębie 22 projektów zgłoszonych przez Apache Software Foundation. Jednym z nich jest Apache Tuscany, w którym aktualnie bierze udział 6-ciu GsoC studentów realizujących 5 tematów. Tuscany cieszy się zainteresowaniem :)

Google Summer of Code 2008

2008-06-14T20:12:00.010+02:00

News jest spóźniony. Przeraźliwie spóźniony. Ale nie mogę o tym nie napisać. 21 kwietnia otrzymałem informację, że zakwalifikowałem się do Google Summer of Code 2008. Nie mogłem uwierzyć!

Ale jak to się stało? Na przełomie marca i kwietnia 2008 roku zacząłem się starać o udział w tegorocznym Google Summer of Code. Właściwie to, gdy ogłoszeno programu byłem trochę sceptycznie nastawiony, jednak kilka rozmów rozjaśniło mi w głowie – "w tym roku spróbuję" - rzekłem do siebie w myślach. Zacząłem od przeglądania dostępnych projektów, wiedziałem że będzie raczej Java, więc na początek zacząłem od listy Apache Software Foundation. Po krótkim przeglądzie kodu Derby i oglądania kwiatków typu metody o nazwach „useMe”, stwierdziłem że grzebanie w... ;) tzn. że Derby nie jest dla mnie. Dalszy przegląd zaowocował poznaniem takich terminów jak... Toskania, czyli rejon geograficzny we Włoszech i tędy krótka droga już do Apache Tuscany (a może to było odwrotnie?;)). Zobaczyłem ciekawe tematy, jak np. portowanie Tuscany na Google-owego Androida, jednak mając świadomość silnej konkurencji wybrałem niszę dla siebie, którą jest również ciekawy projekt, a po naszemu mniej więcej „Wsparcie dla CORBA w Apache Tuscany” - stworzenie binding extension, interface extension dla obiektów CORBA i języka IDL. Dalej poszło już samo, skontaktowałem się z potencjalnymi mentorami, zapisałem do listy mailingowej i zacząłem pisać podanie, które okazało się być wystarczająco dobre. Po drodze otrzymałem jeszcze miłą niespodziankę, w postaci przedłużenia deadline-u podań o tydzień, co być może uratowało sprawę.

Uczestnictwo w GSoC2008 wiązało się również z podjęciem ważnego wyboru – rezygnacji z pracy zarobkowej. W końcu obowiązków byłoby za dużo, a stypendium fundowane przez Google nie jest wcale takie niskie. Tak więc prawie po dwóch latach ponownie prowadzę żywot wesołego studenta. ;)

Jak wygląda postęp prac? Właściwie to czasowo jestem prawie w połowie pierwszego (z dwóch) etapu. Aktualnie pracuję nad reference bindingiem dla CORBY, a do okolic 7 lipca chciałbym ukończyć service binding. Życie jest jednak brutalne, i od dłuższego czasu zamiast wesoło kodować, ustalam kolejne szczegóły, bo jednak chyba okazało się, że autor tematu miał co innego niż ja na myśli.

Trzymajcie kciuki!

Pragmatyczne blogowanie

2008-05-17T20:41:00.004+02:00

Czytąc sobie "Pragmatczynego programistę" natrafiwszy na rozdział o wersjonowaniu wszystkiego-co-się-rusza ;) zdałem sobię sprawę, że dobrze by było przetrzymywać wpisy z bloga w prywatnym SVN-ie. Takowego prywatnego posiadam, a kopii tekstów prócz bloggera nie mam - co jest złe. Kolejnym złem jest, że edytor wpisów z bloggera jest, delikatnie mówiąc, ułomny - brak w nim możliwości chociażby cytowania kodu źródłowego, a sposób w jaki go wstawiam (copy-paste z generatora bloku kodu gdzieś na www) sprawia, że kody często się rozjeżdzaja. Tak naprawdę to pewne możliwości przynośi edytor kodu HTML z bloggera, ale dzisiaj nikt o zdrowych zmysłach nie pisze czystego HTML (przepraszam tych o niezdrowych zmysłach :D). Wszystko to mało wygodne, mało pragmatyczne, mało genertyczne i bardzo chaotyczne.

Wniosek nasuwa się jeden - użyć jakiegoś Worda, przechowywać wersje w SVN-ie (bieda, bo binarki), generować z tego HTML i wklejać do bloggera, lub - pisać posty w Tex, wersjonować (plain text!) generować dokumenty do HTML, i metodologią Copiego-Paste-a aplikować do bloggera.
To drugie bardziej mi się podoba, niestety jak narazie na etapie tworzenia środowiska dla Tex i tego, abym mógł generować HTML, co jak się okazuje, sprawą banalną wcale nie jest.

Oczywiście ten post nie jest również zwersjonowany, a im później opracuję rozwiązanie, tym więcej roboty będę miał.

Rozszerzanie Apache Tuscany: typy wiązań (Extension bindings)

2008-05-07T10:28:00.091+02:00

Rozszerzanie Apache Tuscany o nowe typy wiązań pozwala na wprowadzanie nowych protokołów komunikacji. Typy wiązań wykorzystywane są więc przez:

referencje (references), w celu przetłumaczenia wywołania na protokół specyficzny dla danej usługi
usługi (services), w celu opisania protokołu jaki zostanie użyty przez klientów korzystających z komponentu

Dla przykładu, wiązanie WebService (WS) pozwala na wywoływanie metod usługi WS (binding zapewnia nam implementację komunikacji z WS), a także na wystawienie światu kompozytu poprzez WS.

Temat rozszerzania Apache Tuscany został całkiem obszernie opisany w dokumencie PDF. Dodatkowe informacje można znaleźć na dość niekompletnym WIKI. Implementację modułów wiązań można znaleźć w kodzie źródłowym Tuscany-ego (java/sca/modules/binding-*), a przykładowy kod przedstawiony w dokumencie PDF w java/sca/samples/binding-echo-extension.

W tym wpisie postaram się przedstawić krok po kroku implementację typowego rozszerzenia. Zamierzam zaimplementować prosty protokół pozwalający wywoływać zdalnie operacje. Jego zasada działania to:

usługa działa przesyłając prosty tekst pomiędzy socketami (TCP), identyfikatorem usługi jest więc nazwa hosta i port
po nawiązaniu połączenia serwer oczekuje od klienta nazwy operacji do wywołania, operacje nie mogą posiadać argumentów wywołania, a zwracają zawsze ciąg znaków. Nazwa operacji kończona jest znakami CR LF tak, aby można było ją wywołać po naciśnięciu klawisza enter w telnecie.
po przesłaniu nazwy operacji serwer wywołuje operację i zwraca napis klientowi, po czym zamyka połączenie

1. Przygotowanie
Będą nam potrzebne:

tracdycyjnie już dowolne środowisko programistyczne
dystrybucja Apache Tuscany w wersji 1.1
pewna wiedza z zakresu SCA/Tuscany, najlepiej mieć już za sobą jakiś przykład z użyciem Tuscany

2. Utworzenie interfejsu reprezentującego zadeklarowane wiązanie
Interfejs będzie Javowym odpowiednikiem zadeklarowanego w pliku .composite wiązania:

package demo;

import javax.xml.namespace.QName;

import org.apache.tuscany.sca.assembly.Binding;
import org.apache.tuscany.sca.assembly.xml.Constants;

public interface DemoBinding extends Binding {
 
 QName BINDING_DEMO_QNAME = new QName(Constants.SCA10_TUSCANY_NS, "binding.demo");
 
 int getPort();
 
 void setPort(int port);
 
}

Metody getPort() i setPort() umieściłem ponieważ wiązanie będzie dodatkowo opisywane przez port nasłuchu usługi, np:

<tuscany:binding.demo URI="somehost" port="2048"/>

Interfejs domyślnie posiada getter i setter dla URI; skorzystamy z nich w celu przechowania nazwy hosta.

3. Implementacja szkieletu
Architektura Tuscany wymaga stworzenia szeregu klas obsługujących rozszerzenie.

3.1 Klasa DemoBindingImpl
Implementacja interfejsu DemoBinding - prosta klasa przechowująca informacje o wiązaniu z pliku composite.

package demo.impl;

import demo.DemoBinding;

public class DemoBindingImpl implements DemoBinding {

 private String name;
 private String URI;
 private int port;

 public boolean isUnresolved() {
  return false;
 }

 public void setUnresolved(boolean unresolved) {
 }

 public String getName() {
  return name;
 }

 public void setName(String name) {
  this.name = name;
 }

 public String getURI() {
  return URI;
 }

 public void setURI(String uri) {
  URI = uri;
 }

 @Override
 public Object clone() throws CloneNotSupportedException {
  return super.clone();
 }

 public int getPort() {
  return port;
 }

 public void setPort(int port) {
  this.port = port; 
 }

}

3.2 Klasa DemoBindingProcessor
Klasa odpowiedzialna za przeczytanie (oraz zapisanie, czego jeszcze nie przetestowałem) konfiguracji bindingu z pliku composite. Warto przyjżeć się metodzie read(), która pokazuje jak tworzony jest obiekt implementujący interfejs DemoBinding.

package demo.impl;

import javax.xml.namespace.QName;
import javax.xml.stream.XMLStreamException;
import javax.xml.stream.XMLStreamReader;
import javax.xml.stream.XMLStreamWriter;

import org.apache.tuscany.sca.contribution.processor.StAXArtifactProcessor;
import org.apache.tuscany.sca.contribution.resolver.ModelResolver;
import org.apache.tuscany.sca.contribution.service.ContributionReadException;
import org.apache.tuscany.sca.contribution.service.ContributionResolveException;
import org.apache.tuscany.sca.contribution.service.ContributionWriteException;

import demo.DemoBinding;

public class DemoBindingProcessor implements StAXArtifactProcessor {

 public QName getArtifactType() {
 return DemoBinding.BINDING_DEMO_QNAME;
 }

 public DemoBinding read(XMLStreamReader reader)
   throws ContributionReadException, XMLStreamException {
  DemoBinding binding = new DemoBindingImpl();
  binding.setURI(reader.getAttributeValue(null, "URI"));
  try {
   binding.setPort(Integer.parseInt(reader.getAttributeValue(null, "port")));
  } catch (NumberFormatException e) {
  }
  return binding;
 }

 public void write(DemoBinding binding, XMLStreamWriter writer)
   throws ContributionWriteException, XMLStreamException {
 }

 public Class getModelType() {
  return DemoBinding.class;
 }

 public void resolve(DemoBinding arg0, ModelResolver arg1)
  throws ContributionResolveException {
 }
}

3.3 Klasa DemoInvoker
To klasa która tłumaczy wywołania Tuscany na wywołanie usługi implementowanego przez nas typu. Przykładowy reference binding będzie łączyć się do socketu na zadanym hoście i porcie, przesyłać nazwę żądanej operacji i zwracać wynik otrzymany z połączenia sieciowego:

package demo.impl;

import java.io.OutputStream;
import java.net.Socket;

import org.apache.tuscany.sca.invocation.Invoker;
import org.apache.tuscany.sca.invocation.Message;

import demo.DemoBinding;

public class DemoInvoker implements Invoker {

 private DemoBinding binding;
 
 public DemoInvoker(DemoBinding binding) {
  this.binding = binding;
 }
 
 public Message invoke(Message msg) {
  try {
   Socket socket = new Socket(binding.getURI(), binding.getPort());
   OutputStream output = socket.getOutputStream();
   output.write(msg.getOperation().getName().concat("\r\n").getBytes());
   output.flush();
   byte[] buffer = new byte[1024];
   int read = socket.getInputStream().read(buffer);
   socket.close();
   msg.setBody(new String(buffer).substring(0, read- 1));
   return msg;
  } catch (Exception e) {
  }
  return msg;
 }

}

3.4 Klasa DemoReferenceBindingProvider
Implementacja interfejsu ReferenceBindingProvider - dostawcy wiązania referencji, twórcy invokera:

package demo.impl;

import org.apache.tuscany.sca.interfacedef.InterfaceContract;
import org.apache.tuscany.sca.interfacedef.Operation;
import org.apache.tuscany.sca.invocation.Invoker;
import org.apache.tuscany.sca.provider.ReferenceBindingProvider;

import demo.DemoBinding;

public class DemoReferenceBindingProvider implements ReferenceBindingProvider {

 private DemoBinding binding;

 public DemoReferenceBindingProvider(DemoBinding binding) {
  this.binding = binding;
 }

 public Invoker createInvoker(Operation operation) {
  return new DemoInvoker(binding);
 }

 public InterfaceContract getBindingInterfaceContract() {
  return null;
 }

 public void start() {
 }

 public void stop() {
 }

 public boolean supportsOneWayInvocation() {
  return false;
 }

}

3.5 Klasa DemoServiceRunnable
Klasa implementująca logikę odpowiedzialną za udostępnienie komponentu jako usługi. Założyłem, że usługa będzie nasłuchiwać na zadanym porcie, a po podłączeniu klienta zwracać wynik metody o nazwie przesłanej przez klienta. Podana metoda zostanie wywołana w komponencie powiązanym z tą usługą. Jeżeli klient prześle nazwę metody nie istniejącej dla interfejsu podpiętego pod wiązanie, to serwer zwróci stosowną informację:

package demo.impl;

import java.net.ServerSocket;
import java.net.Socket;
import java.util.List;

import org.apache.tuscany.sca.interfacedef.Operation;
import org.apache.tuscany.sca.runtime.RuntimeComponentService;

import demo.DemoBinding;

public class DemoServiceRunnable implements Runnable {

 private RuntimeComponentService service;
 private DemoBinding binding;
 
 public DemoServiceRunnable(RuntimeComponentService service, DemoBinding binding) {
  this.service = service;
  this.binding = binding;
 }
 
 private boolean active;

 public boolean isActive() {
  return active;
 }
  
 public void setActive(boolean active) {
  this.active = active;
 }
 
 public void run() {
  active = true;
  try {
   ServerSocket ssocket = new ServerSocket(binding.getPort());
   while (isActive()) {
    Socket csocket = ssocket.accept();
    handleRequest(csocket);
   }
  } catch (Exception e) {
   e.printStackTrace();
  }
 }
 
 private void handleRequest(Socket csocket) throws Exception {
  byte[] buffer = new byte[1024];
  csocket.getInputStream().available();
  int read = csocket.getInputStream().read(buffer);
  String requestedOperation = new String(buffer);
  requestedOperation = requestedOperation.substring(0, read - 2);
  List operations = service.getInterfaceContract().getInterface().getOperations();
  String retString = null;
  for (Operation operation : operations) {
   if (operation.getName().equals(requestedOperation)) {
    retString = (String) service.getRuntimeWire(binding).invoke(operation, new Object[0]) + "\nBinding name: " + binding.getName();
    break;
   }
  }
  if (retString == null) {
   retString = "Requested operation " + requestedOperation + " not found!";
  }
  csocket.getOutputStream().write(new String(retString + "\n").getBytes());
  csocket.getOutputStream().flush();    
  csocket.close();
 }
 
}

3.6 Klasa DemoServiceBindingProvider
Implementacja interfejsu ServiceBindingProvider - dostawcy wiązania usługi:

package demo.impl;

import org.apache.tuscany.sca.interfacedef.InterfaceContract;
import org.apache.tuscany.sca.provider.ServiceBindingProvider;
import org.apache.tuscany.sca.runtime.RuntimeComponentService;

import demo.DemoBinding;

public class DemoServiceBindingProvider implements ServiceBindingProvider {

 private DemoServiceRunnable serviceHandler;
 private RuntimeComponentService service;

 public DemoServiceBindingProvider(RuntimeComponentService service, DemoBinding binding) {
  this.service = service;
  this.serviceHandler = new DemoServiceRunnable(service, binding);
 }

 public InterfaceContract getBindingInterfaceContract() {
  return service.getInterfaceContract();
 }

 public void start() {
  Thread thread = new Thread(serviceHandler);
  thread.start();
 }

 public void stop() {
  serviceHandler.setActive(false);
 }

 public boolean supportsOneWayInvocation() {
  return false;
 }

}

3.7 DemoBindingProviderFactory
Implementacja interfejsu BindingProviderFactory - fabryki dostawców referencji i usług:

package demo.impl;

import org.apache.tuscany.sca.provider.BindingProviderFactory;
import org.apache.tuscany.sca.provider.ReferenceBindingProvider;
import org.apache.tuscany.sca.provider.ServiceBindingProvider;
import org.apache.tuscany.sca.runtime.RuntimeComponent;
import org.apache.tuscany.sca.runtime.RuntimeComponentReference;
import org.apache.tuscany.sca.runtime.RuntimeComponentService;

import demo.DemoBinding;

public class DemoBindingProviderFactory implements BindingProviderFactory {

 public ReferenceBindingProvider createReferenceBindingProvider(RuntimeComponent rc, RuntimeComponentReference rcr, DemoBinding binding) {
  return new DemoReferenceBindingProvider(binding);
 }

 public ServiceBindingProvider createServiceBindingProvider(RuntimeComponent rc, RuntimeComponentService rcs, DemoBinding binding) {
  return new DemoServiceBindingProvider(rcs, binding);
 }

 public Class getModelType() {
  return DemoBinding.class;
 }

}

4. Integrownie rozszerzenia z Apache Tuscany
Włączenie rozszerzenia sprowadza się do stworzenia klasy aktywatora oraz wskazania jej w jednym z plików konfiguracyjnych.

4.1 Aktywator - klasa demo.activation.DemoModuleActivator interfejsu ModuleActivator:

package demo.activation;

import org.apache.tuscany.sca.contribution.processor.StAXArtifactProcessorExtensionPoint;
import org.apache.tuscany.sca.core.ExtensionPointRegistry;
import org.apache.tuscany.sca.core.ModuleActivator;
import org.apache.tuscany.sca.provider.ProviderFactoryExtensionPoint;

import demo.impl.DemoBindingProcessor;
import demo.impl.DemoBindingProviderFactory;

public class DemoModuleActivator implements ModuleActivator {

 public void start(ExtensionPointRegistry registry) {
  StAXArtifactProcessorExtensionPoint processors = registry.getExtensionPoint(StAXArtifactProcessorExtensionPoint.class);
  processors.addArtifactProcessor(new DemoBindingProcessor());
  ProviderFactoryExtensionPoint providerFactories = registry.getExtensionPoint(ProviderFactoryExtensionPoint.class);
  providerFactories.addProviderFactory(new DemoBindingProviderFactory());  
 }

 public void stop(ExtensionPointRegistry arg0) {  
 }

}

Interfejs posiada dwie metody: start() i stop(), wykonywane odpowiednio przy starcie i zatrzymaniu modułu.
Rozszerzenia rejestrujemy w Tuscany w tzw. extension pointach, i tak w powyższej klasie wykorzystujemy extension pointy:

StAXArtifactProcessorExtensionPoint - rejestr procesorów artefaktów DOM, w naszym przypadku zarejestrujemy uprzednio stworzony DemoBindingProcessor
ProviderFactoryExtensionPoint - rejestr fabryk dostawców rozszerzeń, w naszym przypadku zarejestrujemy DemoBindingProviderFactory

4.2 Konfiguracja
Należy dopisać do pliku META-INF/services/org.apache.tuscany.sca.core.ModuleActivator nazwę klasy aktywatora:

demo.activation.DemoModuleActivator

5. Test, czyli pokażmy że to działa
Scenariusz testu przewiduje:

wystawienie usługi poprzez "gniazdkowy" ;) protokół
wywołanie zdalnej operacji poprzez "gniazdkowy" protokół. Nie będziemy pisać osobnej usługi działającej wg. tego protokołu - wykorzystamy usługę opisaną w poprzednim punkcie, która będzie "wystawiana" przez Tuscany

Poniżej diagram kompozytu, który stworzymy (zrobiłem go przy użyciu dia, właściwie to istnieje plugin dla eclipse umożliwiający tworzenie takich diagramów i pliki composite przy pomocy GUI, jednak miałem pewne trudności z jego poprawną instalacją).

5.1 Interfejs demo.test.RemoteDemoInterface będzie interfejsem skojarzonym z reference bindingiem:

package demo.test;

import org.osoa.sca.annotations.Remotable;

@Remotable
public interface RemoteDemoInterface  {

 String executeServiceTest();
 
}

5.2 Interfejs demo.test.BindingTest
Lista operacji udostępnianych poprzez nasz protokół:

package demo.test;

public interface BindingTest {

 String executeServiceTest();
 
}

5.3 Klasa demo.test.BindingTestImpl posłuży nam za implementację komponentu oraz miejsce przetestowania bindingu:

package demo.test;

import org.apache.tuscany.sca.host.embedded.SCADomain;
import org.osoa.sca.annotations.Reference;

public class BindingTestImpl implements BindingTest {

 private RemoteDemoInterface demoBinding;
 
 @Reference
 public void setDemoBinding(RemoteDemoInterface demoBinding) {
  this.demoBinding = demoBinding;
 }
 
 public String executeReferenceTest() {
  return demoBinding.executeServiceTest();
 }

 public String executeServiceTest() {
  return "This is method for service";
 }
 
 public static void main(String[] args) {
  SCADomain domain = SCADomain.newInstance("demo/test/BindingTest.composite");
  BindingTestImpl test = domain.getService(BindingTestImpl.class, "BindingTest");
  System.out.println(test.executeReferenceTest());
 }
}

Metoda executeServiceTest() jest przeznaczona do użytku klientów service bindingu. Metoda executeReferenceTest() zostanie wywołana lokalnie (z metody uruchomieniowej main) i spowoduje zdalne wywołanie usługi, a finalnie metody executeServiceTest().

5.4 Stwórzmy plik demo/test/BindingTest.composite opisujący referencję i usługi dla stworzonych reference/service bindingów:

<composite xmlns="http://www.osoa.org/xmlns/sca/1.0"
         xmlns:tuscany="http://tuscany.apache.org/xmlns/sca/1.0"
         targetNamespace="http://sample"
         xmlns:sample="http://sample"
         name="BindingTestComposite">

 <component name="BindingTest">
  <implementation.java class="demo.test.BindingTestImpl" />
 </component>

 <reference name="DemoReference" promote="BindingTest/demoBinding">
  <tuscany:binding.demo URI="localhost" port="2048"/>
 </reference>

 <service name="DemoServiceBinding" promote="BindingTest">
  <interface.java interface="demo.test.BindingTest"/>
  <tuscany:binding.demo port="2048"/>
 </service>

</composite>

Wynik działania klasy uruchomieniowej:

This is method for service
Binding name: DemoServiceBinding2048

W celu przetestowania service bindingu podłączmy się telnetem do Tuscany-ego na port 2048, wywołajmy dozwoloną (executeServiceTest) oraz nie istniejącą (executeNonExistingTest) operację (kolorem niebieskim oznaczyłem tekst wprowadzany przez użytkownika):

jnk@blackhawk:~$ telnet localhost 2048
Trying 127.0.0.1...
Connected to localhost.
Escape character is '^]'.
executeServiceTest
This is method for service
Binding name: DemoServiceBinding2048
Connection closed by foreign host.
jnk@blackhawk:~$ telnet localhost 2048
Trying 127.0.0.1...
Connected to localhost.
Escape character is '^]'.
executeNonExistingTest
Requested operation executeNonExistingTest not found!
Connection closed by foreign host.

Asynchroniczne wołanie metod (AMI) w JacORB

2008-05-01T18:19:00.024+02:00

W tym wpisie spróbuję pokazać tzw. Asynchronous Method Invocation (AMI) w prostej aplikacji z użyciem CORBA. Potrzebne będą nam:

raczej dowolne środowisko programistyczne dla Javy
zainstalowana dystrubucja JacORB (strona JacORB)

Przykładowy program znajduje się w dystrubucji JacORBa, w katalogu demo/ami.

Jak zrezalizowano asynchroniczne wołanie metod?
Klient woła metodę odległego obiektu, a w celu otrzymania wyniku udostępnia interfejs zwrotny, również poprzez CORBA. Klient udostępnia 2 metody zwrotne dla serwera:

Metodę - punkt przekazania wyniku działania metody serwera.
Metodę wyjątku, pozwalającą przekazać do klienta napotkany na serwerze wyjątek.

Przykładowa aplikacja krok po kroku
Stwórzmy zdalny obiekt, który wywoływany asynchronicznie będzie dostarczał usługę dzielenia dwóch liczb całkowitych.

1. Interfejs zdalnego obiektu.
Nasz zdalny obiekt (Calc) będzie posiadał jedną metodę - dzielenie dwóch liczb. Zapiszmy to w pliku calc.idl w głównym drzewie ze źródłami projektu:

module demo {
 interface Calc {
     double div(in long p1, in long p2);
 };
};

2. Wygenerowanie szkieletów i namiastek
Posłużymy się skryptem idl w binariach JacORBa. Kompilację pliku calc.idl wykonujemy poprzez polecenie idl -ami_callback calc.idl. Przełącznik -ami_callback spowoduje wygenerowanie dodatkowych klas, odpowiedzialnych za dostarczenie bazy dla komunikacji asynchronicznej.

3. Implementacja logiki
Otrzymany zestaw klas pozwala nam na impementację obiektu serwera oraz wspomnianych w pkt. 1 metod klienta.

3.1 Logika serwera
Stwórzmy klasę CalcPOAImpl, która będzie specjalizacją abstrakcyjnej klasy CalcPOA. Zaimplementujmy logikę aplikacji poprzez implementację metody div:

package demo;

public class CalcPOAImpl extends CalcPOA {

 public double div(int p1, int p2) {
  return p1 / p2;
 }

}

3.2 Metody zwrotne (klient)
Stwórzmy klasę AMI_CalcHandlerPOAImpl, która będzie specjalizacją abstrakcyjnej klasy AMI_CalcHandlerPOA. Zaimplementujmy logikę klienta w przypadku zwrócenia wyniku przez serwer (metoda div) bądź podniesienia wyjątku (div_excep):

package demo;

import org.omg.Messaging.ExceptionHolder;

public class AMI_CalcHandlerPOAImpl extends AMI_CalcHandlerPOA {

 public void div(double ami_return_val) {
  System.out.println("Klient: serwer zwrócił wynik: " + ami_return_val);
 }

 public void div_excep(ExceptionHolder excep_holder) {
  System.out.println("Klient: serwer podniósł wyjątek");
 }

}

4. Implementacja serwera i klienta
Implementacja serwera:

package demo;

import org.omg.CORBA.*;
import org.omg.PortableServer.*;

public class MyServer {
 public static void main(String args[]) {
  try {
   ORB orb = ORB.init(args, null);
   POA poa = POAHelper.narrow(orb.resolve_initial_references("RootPOA"));
   poa.the_POAManager().activate();
   CalcPOAImpl s = new CalcPOAImpl();
   org.omg.CORBA.Object obj = poa.servant_to_reference(s);
   orb.object_to_string(obj);
   System.out.println(orb.object_to_string(obj));
   orb.run();
  } catch (Exception e) {
   System.out.println("ERROR : " + e);
   e.printStackTrace(System.out);
  }
 }
}

Implementacja klienta:

package demo;

import org.omg.CORBA.*;
import org.omg.PortableServer.*;

public class MyClient {

 public static void main(String[] args) throws Exception {
  if (args.length != 1) {
   System.out.println("Usage: object reference");
   System.exit(1);
  }
  try {
   ORB orb = (ORB) ORB.init(args, null);
   POA poa = (POA) POAHelper.narrow(orb.resolve_initial_references("RootPOA"));
   poa.the_POAManager().activate();
   org.omg.CORBA.Object obj = orb.string_to_object(args[0]);
   Calc s = (Calc) CalcHelper.narrow(obj);
   AMI_CalcHandler h = (AMI_CalcHandler) new AMI_CalcHandlerPOAImpl()._this(orb);
   System.out.print("* 1 / 1 = ");
   ((_CalcStub) s).sendc_div(h, 1, 1);
   System.out.print("* 1 / 0 = ");
   ((_CalcStub) s).sendc_div(h, 1, 0);
   try {
     Thread.sleep(10000);
   } catch (InterruptedException ex) {
    ex.printStackTrace();
   }
  } catch (Exception ex) {
   System.err.println(ex);
  }
 }

}

I wreszcie 5. Uruchamianie
Zarówno serwer jak i klienta możemy uruchomić skryptem jaco znajdującym się w katolugu bin JacORBa. Innym wyjściem jest dodanie parametrów JVM np. ze środowiska programistycznego:

-Djacorb.home=<ścieżka do JacORB>
-Dorg.omg.CORBA.ORBClass=org.jacorb.orb.ORB
-Dorg.omg.CORBA.ORBSingletonClass=org.jacorb.orb.ORBSingleton

Serwer po uruchomieniu wypisze na ekran łańcuch znaków będący referencją do serwowanego obiektu CORBA. Argumentem uruchomienia klienta jest właśnie ta poprzednio podana referencja.

Przykładowy klient wykona dwa razy zdalną metodę, pierwszy raz poprawnie, drugi raz prowokując podniesienie wyjątku dzielenia przez 0. Wynikiem działania klienta powinno być:

* 1 / 1 = Klient: serwer zwrócił wynik: 1.0
* 1 / 0 = Klient: serwer podniósł wyjątek

Powodzenia!

Wprowadzenie do Service Component Architecture cz. 3: Przykładowa aplikacja

2008-04-20T17:07:00.047+02:00

W tym wpisie zaprezentuję proces tworzenia prostej aplikacji z wykorzystaniem SCA.

Wymagania:

Dowolne środowisko programistyczne Java
Dystrybucja Apache Tuscany SCA Java
Serwer aplikacyjny lub kontener serwletów z możliwością wystawienia usługi WebService

Scenariusz.
Wyobraźmy sobie, że chcemy stworzyć program pobierający zlokalizowany stan danego konta bankowego. Zlokalizowany oznacza, że stan konta zostanie podany w konkretnej walucie, zależnej od parametru. Program będzie udostępniał swiatu swoje usługi poprzez interfejs WebService.

Przyjmijmy, że mamy dostęp do:

usługi (WebService) pobierającą stan konta bankowego w PLN.
implementację klienta, który skonwertuje daną wartość do podanej waluty (żeby było ciekawiej, jest to klient w... JavaScript!).

1. Utworzenie interfejsów
Mamy dostęp i musimy skorzystać z dwóch zewnętrznych komponentów programowych (WebService i funkcja JavaScript). Aby uzyskać do nich dostęp stwórzmy ich interfejsy.

AccountInfo.java - interfejs usługi dostępu do stanu konta (docelowym obiektem jest WebService)

package demo;

import org.osoa.sca.annotations.Remotable;

@Remotable
public interface AccountInfo {

double getAccountInfo(int accountId);

}

CurrencyConverter.java - interfejs usługi konwersji waluty (docelowo JavaScript)

package demo;

public interface CurrencyConverter {

double convert(double amount, String currencyCode);

}

LocalizedAccountInfo.java - interfejs wystawianej przez nas usługi

package demo;

public interface LocalizedAccountInfo {

double getAccountInfo(int accountId, String currencyCode);

}

2. Utworzenie usług
Musimy także zasymulować istnienie wspomnianych usług, stwórzmy więc funkcję JavaScript w pliku script/cconvert.js:

function convert(amount, currencyCode) {

if (currencyCode == "PLN") {
 return amount;
} else if (currencyCode == "USD") {
 return amount / 2;
} else if (currencyCode == "EUR") {
 return amount / 3;
}
}

Pozostał jeszcze WebService pobierający stan konta. Ustalmy, że stan konta będzie taki jak jego identyfikator - przykład:

package demo;

import javax.jws.WebMethod;
import javax.jws.WebParam;
import javax.jws.WebService;

@WebService()
public class AccountService {

@WebMethod(operationName = "getAccountInfo")
public double getAccountInfo(@WebParam(name = "accountId") int accountId) {
 return accountId;
}

}

Implementację i deployment usługi pozostawiam czytelnikowi. Co będzie nam potrzebne, to działający WebService, oraz jego WSDL, który musi znaleźć się w katalogu "wsdl" w projekcie.

3. Utworzenie implementacji
Stwórzmy teraz klasę implementującą naszą logikę. Pamiętajmy, że będziemy mieć do dyspozycji obiekty dostępu do implementacji informacji o stanie konta (AccountInfo.java) oraz konwertera waluty (CurrencyConverter.java). Wykorzystajmy je więc i opakujmy setterami:

package demo;

import org.osoa.sca.annotations.Reference;

public class LocalizedAccountInfoImpl implements LocalizedAccountInfo {

private AccountInfo accountInfo;
private CurrencyConverter currencyConverter;

@Reference
public void setCurrencyConverter(CurrencyConverter currencyConverter) {
 this.currencyConverter = currencyConverter;
}

@Reference
public void setAccountInfo(AccountInfo accountInfo) {
 this.accountInfo = accountInfo;
}

public double getAccountInfo(int accountId, String currencyCode) {
 double amount = accountInfo.getAccountInfo(accountId);
 return currencyConverter.convert(amount, currencyCode);
}

}

Adnotacja @Reference przy setterach mówi środowisku uruchomieniowemu, że należy "podmapować" jeden ze skonfigurowanych dalej obiektów do danego pola.

Logika aplikacji w oparciu o zewnętrzne komponenty znajduje się w metodzie getAccountInfo(...).

4. Konfiguracja Apache Tuscany.
Stwórzmy plik konfiguracyjny AccountInfo.composite.

<composite xmlns="http://www.osoa.org/xmlns/sca/1.0"
xmlns:tuscany="http://tuscany.apache.org/xmlns/sca/1.0"
targetNamespace="http://sample"
xmlns:sample="http://sample"
name="Bank">

</composite>

4.1 Definicja referencji do konwertera walut.

<component name="CurrencyConverter">
<tuscany:implementation.script script="script/cconvert.js"/>
</component>

4.2 Definicja komponentu LocalizedAccountInfo z wbudowaną referencją do usługi AccountInfo.

<component name="LocalizedAccountInfo">
<implementation.java class="demo.LocalizedAccountInfoImpl" />
<reference name="currencyConverter" target="CurrencyConverter"/>
<reference name="accountInfo">
<binding.ws wsdlElement="http://demo/#wsdl.port(AccountServiceService/AccountServicePort)"/>
</reference>
</component>

Mając tak stworzony plik konfiguracyjny, przetestujmy działanie kompozycji tworząc klasę startową LocalizedAccountInfoTest.java:

package demo;

import org.apache.tuscany.sca.host.embedded.SCADomain;

public class LocalizedAccountInfoTest {

public static void main(String[] args) {
 SCADomain domain = SCADomain.newInstance("AccountInfo.composite");
 LocalizedAccountInfo lai = domain.getService(LocalizedAccountInfo.class, "LocalizedAccountInfo");
 System.out.println(lai.getAccountInfo(100, "PLN"));
 System.out.println(lai.getAccountInfo(100, "EUR"));
 System.out.println(lai.getAccountInfo(100, "USD"));
}

}

Uruchomienie klasy startowej powinno nam dać rezultat:

100.0
33.333333333333336
50.0

5. Udostępnienie kompozytu poprzez usługę WebService.
Aby udostępnić nasz komponent jako WebService zmodyfikujmy plik konfiguracyjny AccountInfo.composite dodając:

<service name="WSLocalizedAccountInfo" promote="LocalizedAccountInfo">
<interface.java interface="demo.LocalizedAccountInfo"/>
<binding.ws uri="http://localhost:9000/LocalizedAccountInfo"/>
</service>

Finalnie plik konfiguracyjny AccountInfo.composite powinien zawierać:

<composite xmlns="http://www.osoa.org/xmlns/sca/1.0"
xmlns:tuscany="http://tuscany.apache.org/xmlns/sca/1.0"
targetNamespace="http://sample"
xmlns:sample="http://sample"
name="Bank">

<component name="LocalizedAccountInfo">
<implementation.java class="demo.LocalizedAccountInfoImpl" />
<reference name="currencyConverter" target="CurrencyConverter"/>
<reference name="accountInfo">
 <binding.ws wsdlElement="http://demo/#wsdl.port(AccountServiceService/AccountServicePort)"/>
</reference>
</component>

<component name="CurrencyConverter">
<tuscany:implementation.script script="script/cconvert.js"/>
</component>

<service name="WSLocalizedAccountInfo" promote="LocalizedAccountInfo">
<interface.java interface="demo.LocalizedAccountInfo"/>
<binding.ws uri="http://localhost:9000/LocalizedAccountInfo"/>
</service>

</composite>

Poprzez ten wpis zdefiniowaliśmy usługę WebService, bazującą na interfejsie java demo.LocalizedAccountInfo (mogliśmy równie dobrze podać interfejs WSDL), "wystawiającą" komponent LoclizedAccountInfo, wiążąc go z podanym URI. Po ponownym uruchomieniu klasy startowej środowisko Apache Tuscany uruchomi wbudowany kontener serwletów Jetty i udostępni WebService. Sprawdźmy to więc poprzez odwiedzenie adresu http://localhost:9000/LocalizedAccountInfo?wsdl.

6. Deployment w kontenerze serwletów.
Temat nie jest jeszcze rozpoznany.

Wprowadzenie do Service Component Architecture cz. 2: Apache Tuscany

2008-04-20T15:54:00.017+02:00

Apache Tuscany został oparty na specyfikacjach zdefiowanych przez Open CSA:

Service Component Architecture (SCA)
Service Data Object (SDO)
Data Access Service (DAS)

Wspomniane technologie są od siebie niezależne oraz dostarczają pełnej infrastruktury do budowy aplikacji opartych na SOA. W tym wpisie interesuje mnie tylko SCA, więc pozostałe (SDO i DAS) postaram się omijać.

Aktualnie Apache Tuscany znajduje się w inkubatorze Apache Podprojekt SCA posiada 3 implementacje:

SCA Java, aktualnie wersja 1.1
SCA Natvie, z implementacją w C++
SCA PHP

Podstawowe elementy:

Komponent (component) – udostępnia/konsumuje usługi
Usługa (service) - deklaracja usługi udostępnianej na zewnątrz
Referencja (reference) – deklaracja odniesienia do zewnętrznej usługi
Implementacja (implementation) – programowy komponent wykorzystywany w tworzeniu usługi
Interfejs – definicja operacji biznesowych udostępnianych przez usługę (Java, WSDL)
Kompozyt – zestaw komponentów, usług, referencji

Środowiska uruchomieniowe:

aplikacja standalone
udostępnianie usług poprzez wbudowany kontener serwletów (Apache, Jetty)
w kontenerze serwletów
serwer aplikacji JEE
OSGi

Rozszerzanie Apache Tuscany: Architektura Apache Tuscany pozwala na łatwe rozszerzanie silnika o nowe elementy, zwane "extension modules":

typy implementacji (implementation types)
typy wiązań (binding types)
typy wiązań danych (data binding types)
typy interfejsów (interface types)

Tuscany wprowadza pojęcie "extension point", czyli definicji miejsca w którym można dodać rozszerzenie. W celu pobrania większej ilości informacji polecam zapoznać się dokumentem PDF.

Wprowadzenie do Service Component Architecture cz. 1: SCA

2008-04-20T14:02:00.022+02:00

Wpis jest silnie inspirowany dokumentem "What is SCA?" ze stron OSOA.

SCA to zbiór specyfikacji opisujących model budowania aplikacji z wykorzystaniem Service-Oriented Architecture. Pierwsza wersja standardu została opublikowana 21. marca 2007.

SCA narzuca organizację aplikacji biznesowej w stylu SOA, z wydzielonymi komponentami implementującymi logikę biznesową, których operacje udostępniane są poprzez usługi, a które mogą korzystać z innych usług poprzez tzw. referencje.

SCA dzieli kroki tworzenia aplikacji SOA na dwie główne części:

implementacja komponentów konsumujących/udostępniających usługi
łączenie zbiorów komponentów celem zbudowania aplikacji biznesowej

SCA kładzie nacisk na odseparowanie implementacji od szczegółów technicznych wykorzystywanych technologii (infrastruktura, metody dostępu do usług) - komponenty SCA operują na poziomie biznesowym.

SCA wspiera implementacje usług stworzonych z pomocą wielu języków programowania (obiektowych, proceduralnych) jak Java, PHP, C++, Cobol, jak i języków XML-centrycznych (?) jak BPEL, XSLT oraz języków deklaratywnych: SQL, XQuery.

SCA wspiera wiązania (bindings) z szerokim zakresem mechanizmów dostępowych do usług (np. Web services, Messaging systems, CORBA). Wiązania tworzone są deklaratywnie, podobnie w deklaratywny sposób wykorzystywane są właściwości infrastruktury (np. bezpieczeństwo, transakcje). SCA definiuje użycie infrastruktury poprzez polityki (Policies) i profile (Profiles).

Poniżej spojrzenie na architekturę przykładowego systemu z poziomu abstrakcji SCA.

Specyfikację SCA można znaleźć tutaj.

Hello World!

2008-04-19T22:07:00.000+02:00

Cóż za typowy początek!
;)