Variables en Java: declaración, tipos y alcance

// Tipo   Nombre      Valor inicial
   int    edad    =   25;
   String nombre  =   "María";
   boolean activo =   true;

int edad;           // Declaración: reserva espacio para un entero
edad = 25;          // Inicialización: asigna el valor 25

String ciudad;      // Declaración de una referencia a String
ciudad = "Madrid";  // Inicialización con un literal de cadena

int edad = 25;
double salario = 2850.75;
boolean esActivo = true;
char inicial = 'J';
String nombre = "Ana García";

int x = 0, y = 0, z = 0;   // Tres enteros en una línea
String nombre, apellido;     // Dos Strings sin inicializar

int poblacion = 47_000_000;          // Más legible que 47000000
long presupuesto = 1_500_000_000L;   // Mil quinientos millones
double pi = 3.141_592_653_589_793;   // Pi con alta precisión
int binario = 0b1010_1100;           // Literal binario: 172
int hex = 0xFF_EC_DE_5E;             // Literal hexadecimal

long distanciaLuna = 384_400_000L;   // L obligatoria para long
float temperatura = 36.6f;            // f obligatoria para float
double gravedad = 9.81;               // Sin sufijo: double por defecto
// Sin sufijo, un entero literal es int y un decimal es double

// Clase String (la más usada)
String nombre = "María López";

// Arrays
int[] calificaciones = {9, 8, 10, 7, 9};
String[] ciudades = new String[3];

// Clases envoltorio (wrapper classes)
Integer edad = 25;           // Autoboxing: int → Integer
Double salario = 2500.50;    // Autoboxing: double → Double

// Colecciones (requieren tipos de referencia)
ArrayList<String> alumnos = new ArrayList<>();
HashMap<String, Integer> notas = new HashMap<>();

public double calcularDescuento(double precio, int porcentaje) {
    // 'descuento' es una variable local
    double descuento = precio * porcentaje / 100.0;
    
    // 'precioFinal' también es local
    double precioFinal = precio - descuento;
    
    return precioFinal;
}
// Aquí 'descuento' y 'precioFinal' ya no existen

public class Empleado {
    // Variables de instancia: cada objeto tiene su propia copia
    private String nombre;
    private double salario;
    private int antiguedad;
    
    public Empleado(String nombre, double salario) {
        this.nombre = nombre;       // this diferencia instancia de local
        this.salario = salario;
        this.antiguedad = 0;        // Valor inicial explícito
    }
}

public class Empleado {
    // Variable estática: compartida por TODOS los objetos
    private static int contadorEmpleados = 0;
    
    // Constante estática: convenio en MAYÚSCULAS
    public static final double SALARIO_MINIMO = 1134.0;
    
    private String nombre;
    
    public Empleado(String nombre) {
        this.nombre = nombre;
        contadorEmpleados++;   // Se incrementa por cada nuevo empleado
    }
    
    public static int getTotal() {
        return contadorEmpleados;
    }
}

// Uso desde fuera de la clase:
System.out.println(Empleado.SALARIO_MINIMO);   // 1134.0
System.out.println(Empleado.getTotal());        // Número de empleados creados

public class EjemploAlcance {
    // Alcance de CLASE: accesible en toda la clase
    private int valorClase = 100;
    
    public void metodoEjemplo() {
        // Alcance de MÉTODO: accesible en todo el método
        int valorMetodo = 50;
        
        for (int i = 0; i < 10; i++) {
            // Alcance de BLOQUE: 'i' solo existe dentro del for
            int temporal = valorMetodo + i;
            System.out.println(temporal);
        }
        
        // ❌ ERROR: 'i' y 'temporal' ya no existen aquí
        // System.out.println(i);        // No compila
        // System.out.println(temporal);  // No compila
        
        // ✅ CORRECTO: 'valorMetodo' sigue vivo
        System.out.println(valorMetodo);
    }
}

public class Producto {
    private String nombre;    // Variable de instancia
    private double precio;    // Variable de instancia
    
    public Producto(String nombre, double precio) {
        // Los parámetros 'nombre' y 'precio' ensombrecen a los atributos
        this.nombre = nombre;   // this.nombre → atributo de instancia
        this.precio = precio;   // nombre (sin this) → parámetro local
    }
}

public class Configuracion {
    // Constante de clase: static + final, nombre en MAYÚSCULAS
    public static final double IVA = 0.21;
    public static final int MAX_INTENTOS = 3;
    public static final String EMPRESA = "Ciberaula S.L.";
    
    // Variable de instancia final: se asigna una vez (en constructor)
    private final String id;
    
    public Configuracion(String id) {
        this.id = id;   // Solo se puede asignar una vez
    }
    
    public void procesar() {
        // Variable local final
        final int limite = 100;
        // limite = 200;  // ❌ ERROR de compilación
        
        // Parámetro final (no se puede reasignar)
        calcular(limite);
    }
    
    private void calcular(final int valor) {
        // valor = 50;   // ❌ ERROR: parámetro final
        System.out.println("Calculando con: " + valor);
    }
}

// Con tipo explícito
String mensaje = "Hola, Java";
ArrayList<String> nombres = new ArrayList<>();
HashMap<String, List<Integer>> mapa = new HashMap<>();

// Con var (equivalente exacto)
var mensaje = "Hola, Java";              // Inferido: String
var nombres = new ArrayList<String>();    // Inferido: ArrayList<String>
var mapa = new HashMap<String, List<Integer>>();  // Inferido

// Especialmente útil con tipos genéricos largos
var iterador = nombres.iterator();       // Inferido: Iterator<String>

byte b = 42;
int i = b;           // byte → int: automático
long l = i;          // int → long: automático
float f = l;         // long → float: automático
double d = f;        // float → double: automático

// Cadena de promoción: byte → short → int → long → float → double

double precio = 29.99;
int precioEntero = (int) precio;      // 29 (se pierde la parte decimal)

long grande = 130;
byte pequeno = (byte) grande;         // -126 (overflow: 130 excede rango byte)

float decimal = 3.14f;
int entero = (int) decimal;           // 3 (truncamiento, no redondeo)

// Para redondear correctamente:
int redondeado = (int) Math.round(decimal);  // 3 (Math.round devuelve long)

// Autoboxing: primitivo → objeto (automático)
Integer edadObj = 25;                 // int → Integer
Double salarioObj = 2500.50;          // double → Double

// Unboxing: objeto → primitivo (automático)
int edad = edadObj;                   // Integer → int
double salario = salarioObj;          // Double → double

// Cuidado con null en unboxing:
Integer valor = null;
// int x = valor;  // ❌ NullPointerException en tiempo de ejecución

public class ValoresPorDefecto {
    // Variables de instancia: tienen valor por defecto
    int numero;
    boolean activo;
    String texto;
    double[] datos;
    
    public void mostrar() {
        System.out.println("int:     " + numero);   // 0
        System.out.println("boolean: " + activo);    // false
        System.out.println("String:  " + texto);     // null
        System.out.println("double[]:" + datos);     // null
    }
    
    public void errorLocal() {
        int local;
        // System.out.println(local);  // ❌ ERROR: variable might not have been initialized
    }
}

int:     0
boolean: false
String:  null
double[]:null

public class RegistroEmpleados {

    // ── Constantes de clase (static final) ──────────────────────
    public static final double SALARIO_MINIMO = 1134.0;
    public static final int MAX_EMPLEADOS = 500;
    public static final String EMPRESA = "Ciberaula S.L.";

    // ── Variable estática: compartida por todas las instancias ──
    private static int totalEmpleados = 0;

    // ── Variables de instancia: propias de cada objeto ──────────
    private final int id;           // final: no cambia después del constructor
    private String nombre;
    private String departamento;
    private double salarioBruto;
    private boolean activo;

    // ── Constructor ─────────────────────────────────────────────
    public RegistroEmpleados(String nombre, String departamento, double salarioBruto) {
        // Shadowing: parámetros 'nombre', 'departamento', 'salarioBruto'
        // ensombrecen a las variables de instancia
        this.id = ++totalEmpleados;
        this.nombre = nombre;
        this.departamento = departamento;
        this.salarioBruto = Math.max(salarioBruto, SALARIO_MINIMO);
        this.activo = true;
    }

    // ── Método con variables locales ────────────────────────────
    public double calcularSalarioNeto() {
        // Variables locales: solo existen dentro de este método
        final double IRPF = 0.15;
        final double SEGURIDAD_SOCIAL = 0.0635;

        double descuentoIrpf = salarioBruto * IRPF;
        double descuentoSS = salarioBruto * SEGURIDAD_SOCIAL;
        double salarioNeto = salarioBruto - descuentoIrpf - descuentoSS;

        return Math.round(salarioNeto * 100.0) / 100.0;  // Redondeo a 2 decimales
    }

    // ── Método con conversión de tipos ──────────────────────────
    public String generarFicha() {
        // Conversión implícita: int → String (concatenación)
        var ficha = new StringBuilder();
        ficha.append("╔══════════════════════════════════════╗\n");
        ficha.append("  FICHA DE EMPLEADO - ").append(EMPRESA).append("\n");
        ficha.append("  ID:           ").append(id).append("\n");
        ficha.append("  Nombre:       ").append(nombre).append("\n");
        ficha.append("  Departamento: ").append(departamento).append("\n");
        ficha.append("  Salario bruto: ").append(String.format("%.2f €", salarioBruto)).append("\n");
        ficha.append("  Salario neto:  ").append(String.format("%.2f €", calcularSalarioNeto())).append("\n");
        ficha.append("  Estado:       ").append(activo ? "Activo" : "Inactivo").append("\n");
        ficha.append("╚══════════════════════════════════════╝");
        return ficha.toString();
    }

    // ── Getters ─────────────────────────────────────────────────
    public int getId() { return id; }
    public String getNombre() { return nombre; }
    public boolean isActivo() { return activo; }
    public static int getTotalEmpleados() { return totalEmpleados; }

    // ── Método main: punto de entrada ───────────────────────────
    public static void main(String[] args) {
        // Variables locales en main
        var emp1 = new RegistroEmpleados("Ana García", "Desarrollo", 3200.0);
        var emp2 = new RegistroEmpleados("Carlos López", "Marketing", 2800.0);
        var emp3 = new RegistroEmpleados("María Torres", "RRHH", 900.0); // Se ajusta al mínimo

        System.out.println(emp1.generarFicha());
        System.out.println();
        System.out.println(emp2.generarFicha());
        System.out.println();
        System.out.println(emp3.generarFicha());

        System.out.println("\n📊 Total empleados registrados: " + RegistroEmpleados.getTotalEmpleados());
        System.out.println("💰 Salario mínimo vigente: " + RegistroEmpleados.SALARIO_MINIMO + " €");
    }
}

╔══════════════════════════════════════╗
  FICHA DE EMPLEADO - Ciberaula S.L.
  ID:           1
  Nombre:       Ana García
  Departamento: Desarrollo
  Salario bruto: 3200.00 €
  Salario neto:  2516.80 €
  Estado:       Activo
╚══════════════════════════════════════╝

╔══════════════════════════════════════╗
  FICHA DE EMPLEADO - Ciberaula S.L.
  ID:           2
  Nombre:       Carlos López
  Departamento: Marketing
  Salario bruto: 2800.00 €
  Salario neto:  2202.20 €
  Estado:       Activo
╚══════════════════════════════════════╝

╔══════════════════════════════════════╗
  FICHA DE EMPLEADO - Ciberaula S.L.
  ID:           3
  Nombre:       María Torres
  Departamento: RRHH
  Salario bruto: 1134.00 €
  Salario neto:  891.42 €
  Estado:       Activo
╚══════════════════════════════════════╝

📊 Total empleados registrados: 3
💰 Salario mínimo vigente: 1134.0 €

public void ejemplo() {
    int resultado;
    // ❌ ERROR de compilación:
    System.out.println(resultado);  // "variable resultado might not have been initialized"
    
    // ✅ CORRECTO:
    int resultado2 = 0;
    System.out.println(resultado2);  // 0
}

String a = new String("hola");
String b = new String("hola");

// ❌ INCORRECTO: compara referencias (direcciones de memoria)
if (a == b) {
    System.out.println("Iguales");  // No se ejecuta
}

// ✅ CORRECTO: compara contenido
if (a.equals(b)) {
    System.out.println("Iguales");  // Sí se ejecuta
}

// ❌ INCORRECTO: división entre enteros → resultado entero
int aprobados = 7;
int total = 10;
double porcentaje = aprobados / total;        // 0.0 (¡no 0.7!)

// ✅ CORRECTO: forzar al menos un operando a double
double porcentaje2 = (double) aprobados / total;  // 0.7
double porcentaje3 = aprobados / (double) total;   // 0.7
double porcentaje4 = aprobados * 1.0 / total;      // 0.7

// ❌ PELIGROSO: unboxing de null lanza NullPointerException
Integer edadObjeto = null;
int edad = edadObjeto;   // NullPointerException en tiempo de ejecución

// ✅ SEGURO: verificar null antes de unboxing
Integer edadObjeto2 = obtenerEdad();  // Puede devolver null
int edad2 = (edadObjeto2 != null) ? edadObjeto2 : 0;

// ❌ INCORRECTO: declarar dentro del bloque y usar fuera
if (condicion) {
    String mensaje = "Aprobado";
}
System.out.println(mensaje);  // ERROR: "cannot find symbol"

// ✅ CORRECTO: declarar antes del bloque
String mensaje;
if (condicion) {
    mensaje = "Aprobado";
} else {
    mensaje = "Suspendido";
}
System.out.println(mensaje);  // OK