Add Some comments on header of the class to help someone to know the

purpose of them
This commit is contained in:
Schoumi 2016-11-02 17:05:47 +01:00
rodzic b000e6b84b
commit 41d60365ec
22 zmienionych plików z 70 dodań i 6 usunięć

Wyświetl plik

@ -46,6 +46,11 @@ import fr.mobdev.lpcprog.fragment.USBListFragment;
import fr.mobdev.lpcprog.listener.ServerListener;
import fr.mobdev.lpcprog.objects.USBDevice;
/*
The only activity of the app. It Handle all change of fragment depending on user actions
the Menu change with fragment
*/
public class MainActivity extends AppCompatActivity implements NavigationView.OnNavigationItemSelectedListener,
USBListFragment.USBInteractionListener,
AddPartFragment.OnAddInteractionListener

Wyświetl plik

@ -43,7 +43,10 @@ import fr.mobdev.lpcprog.managers.IspManager;
import fr.mobdev.lpcprog.managers.NetworkManager;
import fr.mobdev.lpcprog.objects.Binary;
import fr.mobdev.lpcprog.objects.Server;
/*
Adapter that handle Binaries List. Binaries are in sections depending on servers. There's only
one list, the class handle sections and items in the adapter
*/
public class BinariesAdapter extends RecyclerView.Adapter<RecyclerView.ViewHolder> {
private static final int SECTION = 0;

Wyświetl plik

@ -30,6 +30,9 @@ import java.util.List;
import fr.mobdev.lpcprog.R;
import fr.mobdev.lpcprog.objects.USBDevice;
/*
Adapter use to display devices pluggued on the device through OTG
*/
public class DeviceAdapter extends RecyclerView.Adapter<DeviceHolder> {
private List<USBDevice> devices;

Wyświetl plik

@ -34,6 +34,9 @@ import fr.mobdev.lpcprog.fragment.PartsFragment;
import fr.mobdev.lpcprog.managers.DatabaseManager;
import fr.mobdev.lpcprog.objects.Part;
/*
Adapter use to display list of µc definitions
*/
public class PartsAdapter extends RecyclerView.Adapter<PartHolder>{
private List<Part> parts;

Wyświetl plik

@ -34,6 +34,10 @@ import fr.mobdev.lpcprog.listener.ServerListener;
import fr.mobdev.lpcprog.managers.DatabaseManager;
import fr.mobdev.lpcprog.objects.Server;
/*
Adapter use to display servers in different sections
*/
public class ServerAdapter extends RecyclerView.Adapter<RecyclerView.ViewHolder> {
private static final int SECTION = 0;

Wyświetl plik

@ -36,6 +36,9 @@ import fr.mobdev.lpcprog.R;
import fr.mobdev.lpcprog.managers.DatabaseManager;
import fr.mobdev.lpcprog.objects.Part;
/*
Fragment that Handle add µC definitions to the Database
*/
public class AddPartFragment extends Fragment {
private Part part;

Wyświetl plik

@ -48,6 +48,9 @@ import fr.mobdev.lpcprog.objects.Server;
import fr.mobdev.lpcprog.objects.USBDevice;
import fr.mobdev.lpcprog.managers.UsbCommManager;
/*
Fragment that handle action on a specific device that can be flash with some Binaries
*/
public class DeviceFragment extends Fragment {
private UsbCommManager comm;

Wyświetl plik

@ -33,6 +33,9 @@ import fr.mobdev.lpcprog.adapters.PartsAdapter;
import fr.mobdev.lpcprog.managers.DatabaseManager;
import fr.mobdev.lpcprog.objects.Part;
/*
Fragment that display list of different µC definitions
*/
public class PartsFragment extends Fragment {
private OnEditPressListener onEditListener;

Wyświetl plik

@ -36,8 +36,8 @@ import fr.mobdev.lpcprog.managers.DatabaseManager;
import fr.mobdev.lpcprog.objects.Server;
/*
* Activity that allow user to manage the server where he want to upload his images. Server must contains a Binaries file to work with the app
*/
Fragment that allow user to manage the server where he want to upload his images. Server must contains a Binaries file to work with the app
*/
public class ServersFragment extends Fragment {
private ServerListener serverListener;

Wyświetl plik

@ -36,6 +36,9 @@ import fr.mobdev.lpcprog.R;
import fr.mobdev.lpcprog.objects.USBDevice;
import fr.mobdev.lpcprog.managers.UsbCommManager;
/*
Fragment use to display USB device plugged through OTG port
*/
public class USBListFragment extends Fragment {
private List<USBDevice> devices;

Wyświetl plik

@ -23,6 +23,10 @@ import java.util.EventListener;
import fr.mobdev.lpcprog.objects.Binary;
import fr.mobdev.lpcprog.objects.Server;
/*
Listener that handle events during download Binary
*/
public interface DownloadListener extends EventListener {
void downloadCanceled(Server server, Binary binary);
void downloadSuccessful(Server server, Binary binary);

Wyświetl plik

@ -22,6 +22,9 @@ import android.widget.ImageView;
import java.util.EventListener;
/*
Listener that handle ISPManager events
*/
public interface FlashListener extends EventListener{
void onStartFlash();
void onSuccess();

Wyświetl plik

@ -21,7 +21,9 @@ package fr.mobdev.lpcprog.listener;
import java.util.EventListener;
import fr.mobdev.lpcprog.objects.Server;
/*
Listener working with the NetworkManager to handle events
*/
public interface NetworkListener extends EventListener{
void startBinaries();
void startServer(Server server);

Wyświetl plik

@ -19,7 +19,9 @@
package fr.mobdev.lpcprog.listener;
import java.util.EventListener;
/*
Listener that handle server add/delete
*/
public interface ServerListener extends EventListener {
void updateServerList();
}

Wyświetl plik

@ -32,6 +32,9 @@ import fr.mobdev.lpcprog.objects.Binary;
import fr.mobdev.lpcprog.objects.Part;
import fr.mobdev.lpcprog.objects.Server;
/*
Singleton use to manage all database access
*/
public class DatabaseManager extends SQLiteOpenHelper {
private static DatabaseManager instance;

Wyświetl plik

@ -36,6 +36,9 @@ import fr.mobdev.lpcprog.objects.Part;
import fr.mobdev.lpcprog.objects.Server;
import fr.mobdev.lpcprog.objects.USBDevice;
/*
Singleton that handle all ISP functions
*/
public class IspManager {
//defines

Wyświetl plik

@ -41,6 +41,9 @@ import fr.mobdev.lpcprog.listener.NetworkListener;
import fr.mobdev.lpcprog.objects.Binary;
import fr.mobdev.lpcprog.objects.Server;
/*
Singleton that handle all network connection
*/
public class NetworkManager {
private NetworkListener listener;

Wyświetl plik

@ -26,7 +26,9 @@ import java.util.ArrayList;
import java.util.List;
import fr.mobdev.lpcprog.objects.USBDevice;
/*
Manager use to manage usb devices
*/
public class UsbCommManager {
private static UsbCommManager instance = null;

Wyświetl plik

@ -18,6 +18,9 @@
package fr.mobdev.lpcprog.objects;
/*
Object that represent a binary for the app
*/
public class Binary {
public long id;
public String name;

Wyświetl plik

@ -18,6 +18,9 @@
package fr.mobdev.lpcprog.objects;
/*
Object that represent µC definition for the app
*/
public class Part {
public long id;
public long part_id;

Wyświetl plik

@ -22,6 +22,9 @@ import java.net.URL;
import java.util.ArrayList;
import java.util.List;
/*
Object that represent Server for the app
*/
public class Server {
public long id;
public URL url;

Wyświetl plik

@ -20,6 +20,9 @@ package fr.mobdev.lpcprog.objects;
import com.ftdi.j2xx.FT_Device;
/*
Object that represent USBDevice as seen by the app
*/
public class USBDevice {
public int PID;
public int VID;