sbxcloud Java

SbxCloud Java SDK

El propósito de esta librería es facilitar el desarrollo de aplicaciones Java con SbxCloud

Si tienes alguna duda te invitamos a participar de nuestro canal de slack, simplemente ingresa a: https://archivodigitalslack.herokuapp.com y pide tu invitación, allí encontrarás personas que como tú están desarrollando sus soluciones con nuestra plataforma.

Para comenzar a usar el SDK de Java, simplemente debemos de agregar la siguientes líneas a nuestra configuración de gradle(build.gradle):

Agregamos jitpack.io como repositorio

        repositories {
            maven {
                url "https://jitpack.io"
            }
        }

Agregamos la librería como dependencia

        dependencies {
            //...otras dependencias de tu proyeco aquí.....
            // librería JSONObject ejemplo compile 'org.json:json:20180130'
            compile 'com.github.sbxcloud:sbxcloudjava:v1.0.x'
            
        }

Esta librería depende de org.json.JSONObject y se basa en annotaciones. Para crear tu propia Clase usuario puedes hacerla así:

public class User {
    @SbxNameField
    String name;

    @SbxUsernameField
    String username;

    @SbxEmailField
    String email;

    @SbxPasswordField
    String password;

    @SbxAuthToken
    String token;

    @SbxKey
    String key;

    public User(String name, String username, String email, String password) {
        this.name = name;
        this.username = username;
        this.email = email;
        this.password = password;
    }
}

Para crear un modelo lo puedes realizar de la siguiente forma: Donde SbxModelName marca el nombre del modelo y el campo name de SbxParamField hace referencia a el nombre de los atributos en Sbxcloud.com

@SbxModelName("Category")
public class Category {

    @SbxKey
    String key;

    @SbxParamField(name = "description")
    String name;

    public Category(){}

    public Category(String name) {
        this.name = name;
    }
}

Si un atributo hace referencia a otro modelo, se puede realizar de la siguiente forma:

@SbxModelName("Product")
public class Product {

    @SbxKey
    String key;

    @SbxParamField(name = "description")
    String name;

    @SbxParamField()
    double price;

    @SbxParamField()
    Date expireAt;

    @SbxParamField()
    Category category;

    public Product(){}

    public Product(String name, double price, Category category) {
        this.category = category;
        this.price = price;
        this.name = name;
        this.expireAt=new Date();
    }
}

Luego, puedes conectarte con tus datos utilizando el cliente hhtp que consideres conveniente. La clase SbxUrlComposer te genera los datos de conexión necesarios y accedes a estos con los métodos getUrl(), getType(), getHeader(), getBody()

public class Main {
    public static void main() {
                //Iniciar la librería con el dominio y el App-key
                 SbxAuth.initializeIfIsNecessary(110,"d4cd3cac-043a-48ab-9d06-18aa4fd23cbd");
        
                //Datos
                //Registrar un usuario
                User user= new User("luis gabriel","lgguzman","lgguzman@sbxcloud.co","123456");
                System.out.println(SbxAuth.getDefaultSbxAuth().getUrlSigIn(user));
        
                //login usuario
                System.out.println(SbxAuth.getDefaultSbxAuth().getUrllogin(user));
                //add manually the response token to the user
                user.token="token-asdf-234-asd";
                SbxAuth.getDefaultSbxAuth().refreshToken(user);
        
                //insertar un modelo
                Category category = new Category("lacteos");
                System.out.println(SbxModelHelper.getUrlInsertOrUpdateRow(category));
                //add manually the response key to the category
                category.key="laksdf-asdf-234-asdf";
        
                //insertar un modelo con referencia
                Product product= new Product("leche",13.00,category);
                System.out.println(SbxModelHelper.getUrlInsertOrUpdateRow(product));
        
                //Buscar los primeros 100 productos cuyo precio sea menor de 40
                SbxQueryBuilder sbxQueryBuilder= SbxModelHelper.prepareQuery(Product.class,1,100);
                sbxQueryBuilder.andWhereLessThan("price",40);
                System.out.println(SbxModelHelper.getUrlQuery(sbxQueryBuilder));
        
        
                 //crea un objeto a partir de un Json y una clase personalizada con anotaciones
                JSONObject jsonObject = new JSONObject("{\"price\":13,\"description\":\"leche\",\"expireAt\":\"2017-02-20T20:45:36.756Z\",\"category\":\"laksdf-asdf-234-asdf\"}");
                Product p=  SbxMagicComposer.getSbxModel(jsonObject,Product.class,0);
        
                //crea objeto incluso si hace referencia a otro
                jsonObject = new JSONObject("{\"_KEY\": \"95979b68-cc4a-416d-46c550380031\",\"price\":13,\"description\":\"leche\",\"expireAt\":\"2017-02-20T20:45:36.756Z\",\"category\":{\"_KEY\": \"laksdf-asdf-234-asdf\",\"description\":\"lacteos\"}}");
                p=  SbxMagicComposer.getSbxModel(jsonObject,Product.class,0);
        
                SbxQueryBuilder sbxQueryBuilder = SbxModelHelper.prepareQueryToDelete(Product.class);
                sbxQueryBuilder.addDeleteKey(SbxModelHelper.getKeyFromAnnotation(p));
                System.out.println(SbxModelHelper.getUrlDelete(sbxQueryBuilder));

    }
}