Document things that are hard and confusing for new users
Use case: In what namespace do I place message types for an Actor?
a) Within the Actor class itself
b) In a companion object to the Actor class
c) In the same package as the Actor
d) In Kansas
Use case: When is it appropriate to use Supervisors?
a) Mondays
b) For mission-critical Actors
c) Always
d) For Remote Actors
Question: How do I write Unit Tests for my Akka Actor app? (btw, we probably should have some form of akka-testkit package with good utils for Unit Testing actors)
=========
Regarding docs / examples as per Viktors suggestion, we have the
patterns for distributed systems, could we have a patterns for
persistence equivalent? I am seeing more and more uses for the
various backend persistence plugins, but as a beginner in that area,
can not see clearly beyond the simple vector / map approaches native
to Akka.
I would love to be able to see how the sorted sets stuff (up and
coming) could be used, or a new example of tags and relationships, or
news article ranking. All the kinds of things web devs do all day
every day :-)
=======
As for the pitfalls list - I haven't looked through the source, but I'm unsure what happens when an actor is restarted. As far as I can tell only the preRestart and postRestart methods are called, but their names imply that something else happens.
a) Within the Actor class itself
b) In a companion object to the Actor class
c) In the same package as the Actor
d) In Kansas
Use case: When is it appropriate to use Supervisors?
a) Mondays
b) For mission-critical Actors
c) Always
d) For Remote Actors
Question: How do I write Unit Tests for my Akka Actor app? (btw, we probably should have some form of akka-testkit package with good utils for Unit Testing actors)
=========
Regarding docs / examples as per Viktors suggestion, we have the
patterns for distributed systems, could we have a patterns for
persistence equivalent? I am seeing more and more uses for the
various backend persistence plugins, but as a beginner in that area,
can not see clearly beyond the simple vector / map approaches native
to Akka.
I would love to be able to see how the sorted sets stuff (up and
coming) could be used, or a new example of tags and relationships, or
news article ranking. All the kinds of things web devs do all day
every day :-)
=======
As for the pitfalls list - I haven't looked through the source, but I'm unsure what happens when an actor is restarted. As far as I can tell only the preRestart and postRestart methods are called, but their names imply that something else happens.
Leave a comment
on 2010-02-17 09:12 *
By Jonas Bonér
Description changed from Use case: In what namespace... to Use case: In what namespace...
on 2010-05-24 07:54 *
By deanwampler
I struggled with going from a RESTful server deployed to the Akka kernel (that was pretty easy!) to building and deploying an actual Jetty web app with web pages, etc. That's one reason I created this sample, http://github.com/deanwampler/AkkaWebSampleExercise, which Jonas wants to merge into the Akka samples.
on 2010-05-25 08:05 *
By Jonas Bonér
From Dustin:
I think it's confusing that you can use akka both in stand-alone-kernel form, and with libs in your own program. I think there needs to be a clear explanation of that, and perhaps it should be clearly documented which attributes in the config file are for stand alone and which are not.
I think it's confusing that you can use akka both in stand-alone-kernel form, and with libs in your own program. I think there needs to be a clear explanation of that, and perhaps it should be clearly documented which attributes in the config file are for stand alone and which are not.
on 2010-05-25 08:06 *
By Jonas Bonér
From Mikael:
Hi,
Great ticket, il think some more about it, but the first thing that comes to mind is that there is not much on getting started with the java api. for example java isnt mentioned in the getting started guide
Something like a mvn archetype to create a java sceleton that uses akka would be nice if thats possible? (im a mvn newbie so dont realy know)
When it comes to working with the akka source, something like a sbt target to create an eclipse/idea/netbeans project would probably be helpfull? or maybe its possible to create a .pom in the root, dont think i got that to work when i tried.
Hi,
Great ticket, il think some more about it, but the first thing that comes to mind is that there is not much on getting started with the java api. for example java isnt mentioned in the getting started guide
Something like a mvn archetype to create a java sceleton that uses akka would be nice if thats possible? (im a mvn newbie so dont realy know)
When it comes to working with the akka source, something like a sbt target to create an eclipse/idea/netbeans project would probably be helpfull? or maybe its possible to create a .pom in the root, dont think i got that to work when i tried.
on 2010-05-25 08:07 *
By Jonas Bonér
From Mikael:
i got curious about the mvn archetype thing.
so i created one from the akka sample for java i had.
http://github.com/bobo/akka_mvn_archetyp
since its in github and not housted you need to:
git clone git://github.com/bobo/akka_mvn_archetyp.git
cd akka_mvn_archetyp
mvn install
then somewhere else in a folder you want your project:
mvn archetype:generate -DarchetypeCatalog=local
and follow the guide, you should have a archetype named something like: akka_sample_java-archetype
in the list.
then you can do mvn test and if you have redis running it should pass
but the code itself is probably not the best choice for a mvn archetype. but atleast i found out that its easy to create.
i got curious about the mvn archetype thing.
so i created one from the akka sample for java i had.
http://github.com/bobo/akka_mvn_archetyp
since its in github and not housted you need to:
git clone git://github.com/bobo/akka_mvn_archetyp.git
cd akka_mvn_archetyp
mvn install
then somewhere else in a folder you want your project:
mvn archetype:generate -DarchetypeCatalog=local
and follow the guide, you should have a archetype named something like: akka_sample_java-archetype
in the list.
then you can do mvn test and if you have redis running it should pass
but the code itself is probably not the best choice for a mvn archetype. but atleast i found out that its easy to create.
Letting this one sort out itself on the mailinglist.