Comentários para tentar deixar o código mais inteligível (ou não), melhor criar métodos auxiliares

java_comentarios.java

class PedidoService {
 
    public Pedido fazPedido(Carrinho carrinho) {
 
        // checar se o carrinho está vazio
        if (carrinho.getItens().size() == 0) {
            throw new IllegalArgumentException("Carrinho Vazio");
        }
 
        // checar se a forma de pagamento foi selecionada
        if (carrinho.getFormaPagamento() == null) {
             throw new IllegalArgumentException("Forma Pagamento não selecionada");
        }
 
        // ################ SE FOR CARTÃO DE CRÉDITO CHECAR SALDO
        if (carrinho.getFormaPagamento() == CARTAO_CREDITO) {
            Cliente cliente = carrinho.getCliente();
            SegurCredWS sc = new SegurCredWS();
            sc.checaCredito(cliente.getCPF()
                                 .replace(".", "").replace("-","."));
            if (!sc.getSituacao().equals(Situacao.OK)) {
                throw new NoCreditException("Cliente não tem crédito liberado");
            }
        }
 
        // CHECAR SE TODOS OS ITENS ESTÃO NO ESTOQUE
        EstoqueService estoqueService = new EstoqueService();
        for (Item item : carrinho.getItens()) {
            if (estoqueService.getQuantidadeEstoque(
               item.getProduto().getCodigo()) < item.getQuantidade()) {
                throw new SemEstoqueParaItem(item);
            }
        }
 
        // ... mais 30 linhas de transação (E 10 DE COMENTÁRIOS!!!)
 
        // CONSTRUIR O PEDIDO !!!!
        Pedido pedido = new Pedido();
        pedido.setItens(carrinho.getItens());
        pedido.setCliente(carrinho.getCliente());
        pedido.setFormaPagamento(carrinho.getFormaPagamento());
 
        // SALVAR O PEDIDO NA BASE DE DADOS
        PedidoDAO pedidoDAO = new PedidoDAO();
        pedidoDAO.salva(pedido);
    }
}

java_metodos_auxiliares.java

class PedidoService {
    public Pedido fazPedido(Carrinho carrinho) {
 
        checaValidadeCarrinho(carrinho);
 
        if (carrinho.getFormaPagamento() == CARTAO_CREDITO) {
            checaCreditoCliente(carrinho.getCliente());
        }
        // ... restante do método chamando métodos menores
        pedidoDAO.salva(pedido);
    }
 
    private void checaValidadeCarrinho(Carrinho carrinho) {
        if (carrinho.getItens().size() == 0) {
            throw new IllegalArgumentException("Carrinho Vazio");
        }
 
        if (carrinho.getFormaPagamento() == null) {
            throw new IllegalArgumentException("Forma Pagamento não selecionada");
        }
    }
 
    private void checaCreditoCliente(Cliente cliente) {
        SegurCredWS sc = new SegurCredWS();
        sc.checaCredito(cliente.getCPF().replace(".", "").replace("-","."));
        if (!sc.getSituacao().equals(Situacao.OK)) {
            throw new NoCreditException("Cliente não tem crédito liberado");
        }
    }
    // ... outros métodos menores
}