24 | * Message chunking is done by prepending the length of a coherent message before the message itself. 25 | *
26 | */ 27 | package de.saxsys.synchronizefx.netty.tcp; -------------------------------------------------------------------------------- /transmitter/netty-transmitter/src/main/java/de/saxsys/synchronizefx/netty/websockets/package-info.java: -------------------------------------------------------------------------------- 1 | /** 2 | * This file is part of SynchronizeFX. 3 | * 4 | * Copyright (C) 2013-2014 Saxonia Systems AG 5 | * 6 | * SynchronizeFX is free software: you can redistribute it and/or modify 7 | * it under the terms of the GNU Lesser General Public License as published by 8 | * the Free Software Foundation, either version 3 of the License, or 9 | * (at your option) any later version. 10 | * 11 | * SynchronizeFX is distributed in the hope that it will be useful, 12 | * but WITHOUT ANY WARRANTY; without even the implied warranty of 13 | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 14 | * GNU Lesser General Public License for more details. 15 | * 16 | * You should have received a copy of the GNU Lesser General Public License 17 | * along with SynchronizeFX. If not, see26 | * This interface is intended to be replaced by the interface of with the same name in Java 8 once Java 7 support is 27 | * dropped. 28 | *
29 | * 30 | * @paramThe executors in this package are execute changes in a way that all models are eventually synchronous. 25 | * That means that these classes repair non-synchronous states on their managed properties on the own. 26 | * Non-synchronous states can happen when multiple peers change the same property at the same time. 27 | * Non-synchronous states can be detected because the server does not only send change events of other peers 28 | * but also change events of the own peer in the order that they where executed on the server.
29 | */ 30 | package de.saxsys.synchronizefx.core.metamodel.executors; -------------------------------------------------------------------------------- /transmitter/netty-transmitter/src/main/java/de/saxsys/synchronizefx/netty/tcp/LengthFieldBasedCodec.java: -------------------------------------------------------------------------------- 1 | /** 2 | * This file is part of SynchronizeFX. 3 | * 4 | * Copyright (C) 2013-2014 Saxonia Systems AG 5 | * 6 | * SynchronizeFX is free software: you can redistribute it and/or modify 7 | * it under the terms of the GNU Lesser General Public License as published by 8 | * the Free Software Foundation, either version 3 of the License, or 9 | * (at your option) any later version. 10 | * 11 | * SynchronizeFX is distributed in the hope that it will be useful, 12 | * but WITHOUT ANY WARRANTY; without even the implied warranty of 13 | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 14 | * GNU Lesser General Public License for more details. 15 | * 16 | * You should have received a copy of the GNU Lesser General Public License 17 | * along with SynchronizeFX. If not, seetrue, if the instance is running, otherwise false
44 | */
45 | public static boolean isRunning() {
46 | return running;
47 | }
48 |
49 | }
50 |
--------------------------------------------------------------------------------
/src/site/markdown/index.md:
--------------------------------------------------------------------------------
1 | JavaFX extends the concept of properties of objects known from JavaBeans.
2 | Instead of using plain fields for properties, special wrapper objects are used for them.
3 | This allows the binding of properties in the model to GUI elements.
4 | E.g. if you have a property _money_ in some domain object you can bind it to some GUI-Label which shows this value.
5 | You can then update this property anywhere in the application and all the GUI-Elements bound to this property would be updated automatically.
6 | When a property is updated there is no need to know what is bound to it and it is no necessary to initiate any update process.
7 | A good introduction to JavaFX properties is the article [Using JavaFX Properties and Binding][jfx-properties]
8 |
9 | [jfx-properties]: http://docs.oracle.com/javafx/2/binding/jfxpub-binding.htm "Using JavaFX Properties and Binding"
10 |
11 | Using only standard JavaFX classes, this concept works only within a single JVM.
12 | The goal of this library is to overcome this limitation.
13 | The main idea is to have a domain model which consists of Java classes containing JavaFX Properties.
14 | A single instance of the domain model is than shared between multiple JVM processes running on different machines.
15 | If a property on any object of the model instance on any machine is changed, all other machines get this change too.
16 | GUI-Elements that are bound to the property on any machine will update them self automatically.
17 | From the user perspective it looks like the change was done in the local JVM.
18 |
19 | Only the root object of the shared model has to be retrieved with some special code.
20 | After that changes on the shared model instance can be done as if it was not shared.
21 | This makes upgrading of existing JavaFX applications very easy.
22 |
--------------------------------------------------------------------------------
/synchronizefx/src/main/java/de/saxsys/synchronizefx/ClientCallbackStep.java:
--------------------------------------------------------------------------------
1 | /**
2 | * This file is part of SynchronizeFX.
3 | *
4 | * Copyright (C) 2013-2014 Saxonia Systems AG
5 | *
6 | * SynchronizeFX is free software: you can redistribute it and/or modify
7 | * it under the terms of the GNU Lesser General Public License as published by
8 | * the Free Software Foundation, either version 3 of the License, or
9 | * (at your option) any later version.
10 | *
11 | * SynchronizeFX is distributed in the hope that it will be useful,
12 | * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 | * GNU Lesser General Public License for more details.
15 | *
16 | * You should have received a copy of the GNU Lesser General Public License
17 | * along with SynchronizeFX. If not, see 40 | * Data recieved over the network enteres the handlers as it comes in in the form of {@link ByteBuf}s. Usually a 41 | * large message will be recieved in multiple small chunks. A chunk can also contain data of multiple messages. 42 | * The handlers added to this pipeline must ensure that further handlers recieve coherent {@link Serializer} 43 | * messages in form of {@link ByteBuf}s. 44 | *
45 | * 46 | * @param pipeline The pipeline to add the handler to. 47 | */ 48 | void addToPipeline(ChannelPipeline pipeline); 49 | } 50 | -------------------------------------------------------------------------------- /synchronizefx-core/src/main/java/de/saxsys/synchronizefx/core/exceptions/SynchronizeFXException.java: -------------------------------------------------------------------------------- 1 | /** 2 | * This file is part of SynchronizeFX. 3 | * 4 | * Copyright (C) 2013-2014 Saxonia Systems AG 5 | * 6 | * SynchronizeFX is free software: you can redistribute it and/or modify 7 | * it under the terms of the GNU Lesser General Public License as published by 8 | * the Free Software Foundation, either version 3 of the License, or 9 | * (at your option) any later version. 10 | * 11 | * SynchronizeFX is distributed in the hope that it will be useful, 12 | * but WITHOUT ANY WARRANTY; without even the implied warranty of 13 | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 14 | * GNU Lesser General Public License for more details. 15 | * 16 | * You should have received a copy of the GNU Lesser General Public License 17 | * along with SynchronizeFX. If not, see36 | * This includes errors occurred in the {@link CommandTransferServer} implementation. 37 | *
38 | * 39 | * @param error the exception that describes the error. 40 | */ 41 | void onError(SynchronizeFXException error); 42 | 43 | /** 44 | * Called when an error with the connection to a client occurred. 45 | * 46 | *47 | * When this event occurs, the server will still work. Just the connection to the affected client is broken. 48 | *
49 | * 50 | * @param client The client for which an error occurred. The type of this object depends on the network layer 51 | * that is used. 52 | * @param error The error that occurred. 53 | */ 54 | void onClientConnectionError(Object client, SynchronizeFXException error); 55 | } 56 | -------------------------------------------------------------------------------- /kryo-serializer/src/main/java/de/saxsys/synchronizefx/kryo/serializer/SetPropertyValueSerializer.java: -------------------------------------------------------------------------------- 1 | /** 2 | * This file is part of SynchronizeFX. 3 | * 4 | * Copyright (C) 2013-2014 Saxonia Systems AG 5 | * 6 | * SynchronizeFX is free software: you can redistribute it and/or modify 7 | * it under the terms of the GNU Lesser General Public License as published by 8 | * the Free Software Foundation, either version 3 of the License, or 9 | * (at your option) any later version. 10 | * 11 | * SynchronizeFX is distributed in the hope that it will be useful, 12 | * but WITHOUT ANY WARRANTY; without even the implied warranty of 13 | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 14 | * GNU Lesser General Public License for more details. 15 | * 16 | * You should have received a copy of the GNU Lesser General Public License 17 | * along with SynchronizeFX. If not, see40 | * Any changes done to the users domain model are executed over the model change executor passed in the constructor. 41 | *
42 | * 43 | * @param observable 44 | * The observable that is changed. 45 | * @param change 46 | * The change that is done to the observable. 47 | */ 48 | public void execute(final Object observable, final Runnable change) { 49 | listeners.disableFor(observable); 50 | change.run(); 51 | listeners.enableFor(observable); 52 | } 53 | 54 | /** 55 | * Registers the listener that should be suspended while modifying observables. 56 | * 57 | * @param listeners 58 | * the listeners 59 | */ 60 | public void registerListenersToSilence(final Listeners listeners) { 61 | this.listeners = listeners; 62 | } 63 | } 64 | -------------------------------------------------------------------------------- /synchronizefx/src/main/assemble/bin.xml: -------------------------------------------------------------------------------- 1 |32 | * This class is intended to be used as input for {@link SynchronizeFxServer}. 33 | *
34 | * 35 | * @author Raik Bieniek 36 | */ 37 | public class NettyServer extends NettyBasicServer { 38 | 39 | private Serializer serializer; 40 | 41 | /** 42 | * Takes the required informations needed to start the server but doesn't actually start it. 43 | * 44 | * The starting of the server is done by {@link SynchronizeFxServer}. 45 | * 46 | * @param port The port to which to listen for new connections. 47 | * @param serializer The serializer that should be used to serialize SynchronizeFX messages. 48 | */ 49 | public NettyServer(final int port, final Serializer serializer) { 50 | super(port); 51 | this.serializer = serializer; 52 | } 53 | 54 | @Override 55 | protected BasicChannelInitializerServer createChannelInitializer() { 56 | return new BasicChannelInitializerServer(serializer, new LengthFieldBasedCodec(), false); 57 | } 58 | 59 | } 60 | -------------------------------------------------------------------------------- /kryo-serializer/src/main/java/de/saxsys/synchronizefx/kryo/serializer/AddToListSerializer.java: -------------------------------------------------------------------------------- 1 | /** 2 | * This file is part of SynchronizeFX. 3 | * 4 | * Copyright (C) 2013-2014 Saxonia Systems AG 5 | * 6 | * SynchronizeFX is free software: you can redistribute it and/or modify 7 | * it under the terms of the GNU Lesser General Public License as published by 8 | * the Free Software Foundation, either version 3 of the License, or 9 | * (at your option) any later version. 10 | * 11 | * SynchronizeFX is distributed in the hope that it will be useful, 12 | * but WITHOUT ANY WARRANTY; without even the implied warranty of 13 | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 14 | * GNU Lesser General Public License for more details. 15 | * 16 | * You should have received a copy of the GNU Lesser General Public License 17 | * along with SynchronizeFX. If not, see34 | * This class is intended to be used as input for {@link SynchronizeFxClient}. 35 | *
36 | * 37 | * @author Raik Bieniek 38 | */ 39 | public class NettyClient extends NettyBasicClient { 40 | 41 | private final Serializer serializer; 42 | 43 | /** 44 | * Takes the required informations to connect to a server but doesn't actually connect to it. 45 | * 46 | * The opening of the connection is done by {@link SynchronizeFxClient}. 47 | * 48 | * @param serverAdress The domain name or IP address of a server to connect to. 49 | * @param port The port of the server to connect to. 50 | * @param serializer The serializer that should be used to serialize SynchronizeFX messages. 51 | */ 52 | public NettyClient(final String serverAdress, final int port, final Serializer serializer) { 53 | super(new InetSocketAddress(serverAdress, port)); 54 | this.serializer = serializer; 55 | } 56 | 57 | @Override 58 | protected BasicChannelInitializerClient createChannelInitializer() { 59 | LengthFieldBasedCodec codec = new LengthFieldBasedCodec(); 60 | return new BasicChannelInitializerClient(serializer, codec, false); 61 | } 62 | } 63 | -------------------------------------------------------------------------------- /kryo-serializer/src/main/java/de/saxsys/synchronizefx/kryo/serializer/ValueSerializer.java: -------------------------------------------------------------------------------- 1 | /** 2 | * This file is part of SynchronizeFX. 3 | * 4 | * Copyright (C) 2013-2014 Saxonia Systems AG 5 | * 6 | * SynchronizeFX is free software: you can redistribute it and/or modify 7 | * it under the terms of the GNU Lesser General Public License as published by 8 | * the Free Software Foundation, either version 3 of the License, or 9 | * (at your option) any later version. 10 | * 11 | * SynchronizeFX is distributed in the hope that it will be useful, 12 | * but WITHOUT ANY WARRANTY; without even the implied warranty of 13 | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 14 | * GNU Lesser General Public License for more details. 15 | * 16 | * You should have received a copy of the GNU Lesser General Public License 17 | * along with SynchronizeFX. If not, see57 | * The index of all items in the list thats index is greater or equal to the value returned here has to be 58 | * incremented by 1 to make this index available. 59 | *
60 | * 61 | * @return The index 62 | */ 63 | public int getPosition() { 64 | return position; 65 | } 66 | 67 | /** 68 | * @return The value to add to the list. 69 | */ 70 | public Value getValue() { 71 | return value; 72 | } 73 | 74 | @Override 75 | public String toString() { 76 | return "AddToList [listId=" + getListId() + ", versionChange=" + getListVersionChange() + ", value=" + value 77 | + ", position=" + position + "]"; 78 | } 79 | } 80 | -------------------------------------------------------------------------------- /synchronizefx-core/src/main/java/de/saxsys/synchronizefx/core/metamodel/commands/RemoveFromList.java: -------------------------------------------------------------------------------- 1 | /** 2 | * This file is part of SynchronizeFX. 3 | * 4 | * Copyright (C) 2013-2014 Saxonia Systems AG 5 | * 6 | * SynchronizeFX is free software: you can redistribute it and/or modify 7 | * it under the terms of the GNU Lesser General Public License as published by 8 | * the Free Software Foundation, either version 3 of the License, or 9 | * (at your option) any later version. 10 | * 11 | * SynchronizeFX is distributed in the hope that it will be useful, 12 | * but WITHOUT ANY WARRANTY; without even the implied warranty of 13 | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 14 | * GNU Lesser General Public License for more details. 15 | * 16 | * You should have received a copy of the GNU Lesser General Public License 17 | * along with SynchronizeFX. If not, seebyte[] to SynchronizeFX
45 | * commands.
46 | */
47 | public CommandToBinaryByteBuf(final Serializer serializer) {
48 | this.serializer = serializer;
49 | }
50 |
51 | @Override
52 | protected void decode(final ChannelHandlerContext ctx, final ByteBuf msg, final List