machine-gun/README at master · felipelalli/machine-gun · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
https://github.com/felipelalli/machine-gun/wiki

The  main  idea  of the /machine-gun/ project is soften a serial data processing
through  persisted  embedded  queues,  specially  if  this  processing take some
time that the main execution flow cannot wait for.

It  is  useful,  e.g.,  if  you  have to persist *a lot of* new data into a slow
database.    You  don't  want  to  block  your  whole  main  flow  to  wait this
turtle.   And  you  cannot  just  start  a  thread  to do this, because: 1. your
RAM  memory  will  get  full  quickly.  2.  if  your  PC  lost the power or your
system  go  down  for  any  weird  reason,   you  are  in  trouble.  So, let put
the  logical  processing  into a  persisted  queue  and  process  it  as soon as
possible, making everything softer.

First,  a /machine-gun/  will  put  everything  in an (limited) internal buffer.
After,   some  consumers  will  put  it  in  an  internal  persisted   queue  to
finally, others consumers to execute the expensive operation.

Everything (like current operation and time slices) can be externally
monitored through an interface called "army audit".

      .
      ,,                        __,--.
     ''      ,                 /_,__,_)        ,----.
     '      /|________________//__   __________|'##'|_____
      =====(  )_##################)==`)###################|
           ,' |_)#################)===)#######__`__`__`___|____
          =`--"._,_,_#############)===)######(_,_,_,_,_,_,_,_,_)
                     '--,_,__,__|.------.,--.,-.[JW],-----'
                                 |-##-| ||  )) |###(
                                 |-##-| '======|,###\
                                 '----'        \,####\
                                                \,####)
                                                 \_,-"

                    MAKE FAST SERIAL PROCESSING

CC-by Felipe Micaroni Lalli <micaroni@gmail.com>
Special thanks to Igor Hjelmstrom Vinhas Ribeiro <igorhvr@iasylum.net>

== Requirements ==
* Java 1.6 or better
* ant 1.8 or better

== How to build ==
Just type "ant" in the project root and follow the instructions.