Estou testando uma amostra com a Room Persistence Library . Eu criei uma Entidade:

@Entity
public class Agent {
    @PrimaryKey
    public String guid;
    public String name;
    public String email;
    public String password;
    public String phone;
    public String licence;
}

Criou uma classe DAO:

@Dao
public interface AgentDao {
    @Query("SELECT COUNT(*) FROM Agent where email = :email OR phone = :phone OR licence = :licence")
    int agentsCount(String email, String phone, String licence);

    @Insert
    void insertAgent(Agent agent);
}

Criou a classe Database:

@Database(entities = {Agent.class}, version = 1)
public abstract class AppDatabase extends RoomDatabase {
    public abstract AgentDao agentDao();
}

Banco de dados exposto usando a subclasse abaixo em Kotlin:

class MyApp : Application() {

    companion object DatabaseSetup {
        var database: AppDatabase? = null
    }

    override fun onCreate() {
        super.onCreate()
        MyApp.database =  Room.databaseBuilder(this, AppDatabase::class.java, "MyDatabase").build()
    }
}

Implementado abaixo a função em minha atividade:

void signUpAction(View view) {
        String email = editTextEmail.getText().toString();
        String phone = editTextPhone.getText().toString();
        String license = editTextLicence.getText().toString();

        AgentDao agentDao = MyApp.DatabaseSetup.getDatabase().agentDao();
        //1: Check if agent already exists
        int agentsCount = agentDao.agentsCount(email, phone, license);
        if (agentsCount > 0) {
            //2: If it already exists then prompt user
            Toast.makeText(this, "Agent already exists!", Toast.LENGTH_LONG).show();
        }
        else {
            Toast.makeText(this, "Agent does not exist! Hurray :)", Toast.LENGTH_LONG).show();
            onBackPressed();
        }
    }

Infelizmente, na execução do método acima, ele trava com o rastreamento de pilha abaixo:

    FATAL EXCEPTION: main
 Process: com.example.me.MyApp, PID: 31592
java.lang.IllegalStateException: Could not execute method for android:onClick
    at android.support.v7.app.AppCompatViewInflater$DeclaredOnClickListener.onClick(AppCompatViewInflater.java:293)
    at android.view.View.performClick(View.java:5612)
    at android.view.View$PerformClick.run(View.java:22288)
    at android.os.Handler.handleCallback(Handler.java:751)
    at android.os.Handler.dispatchMessage(Handler.java:95)
    at android.os.Looper.loop(Looper.java:154)
    at android.app.ActivityThread.main(ActivityThread.java:6123)
    at java.lang.reflect.Method.invoke(Native Method)
    at com.android.internal.os.ZygoteInit$MethodAndArgsCaller.run(ZygoteInit.java:867)
    at com.android.internal.os.ZygoteInit.main(ZygoteInit.java:757)
 Caused by: java.lang.reflect.InvocationTargetException
    at java.lang.reflect.Method.invoke(Native Method)
    at android.support.v7.app.AppCompatViewInflater$DeclaredOnClickListener.onClick(AppCompatViewInflater.java:288)
    at android.view.View.performClick(View.java:5612) 
    at android.view.View$PerformClick.run(View.java:22288) 
    at android.os.Handler.handleCallback(Handler.java:751) 
    at android.os.Handler.dispatchMessage(Handler.java:95) 
    at android.os.Looper.loop(Looper.java:154) 
    at android.app.ActivityThread.main(ActivityThread.java:6123) 
    at java.lang.reflect.Method.invoke(Native Method) 
    at com.android.internal.os.ZygoteInit$MethodAndArgsCaller.run(ZygoteInit.java:867) 
    at com.android.internal.os.ZygoteInit.main(ZygoteInit.java:757) 
 Caused by: java.lang.IllegalStateException: Cannot access database on the main thread since it may potentially lock the UI for a long periods of time.
    at android.arch.persistence.room.RoomDatabase.assertNotMainThread(RoomDatabase.java:137)
    at android.arch.persistence.room.RoomDatabase.query(RoomDatabase.java:165)
    at com.example.me.MyApp.RoomDb.Dao.AgentDao_Impl.agentsCount(AgentDao_Impl.java:94)
    at com.example.me.MyApp.View.SignUpActivity.signUpAction(SignUpActivity.java:58)
    at java.lang.reflect.Method.invoke(Native Method) 
    at android.support.v7.app.AppCompatViewInflater$DeclaredOnClickListener.onClick(AppCompatViewInflater.java:288) 
    at android.view.View.performClick(View.java:5612) 
    at android.view.View$PerformClick.run(View.java:22288) 
    at android.os.Handler.handleCallback(Handler.java:751) 
    at android.os.Handler.dispatchMessage(Handler.java:95) 
    at android.os.Looper.loop(Looper.java:154) 
    at android.app.ActivityThread.main(ActivityThread.java:6123) 
    at java.lang.reflect.Method.invoke(Native Method) 
    at com.android.internal.os.ZygoteInit$MethodAndArgsCaller.run(ZygoteInit.java:867) 
    at com.android.internal.os.ZygoteInit.main(ZygoteInit.java:757) 

Parece que o problema está relacionado à execução da operação db no thread principal. No entanto, o código de teste de amostra fornecido no link acima não é executado em uma thread separada:

@Test
    public void writeUserAndReadInList() throws Exception {
        User user = TestUtil.createUser(3);
        user.setName("george");
        mUserDao.insert(user);
        List<User> byName = mUserDao.findUsersByName("george");
        assertThat(byName.get(0), equalTo(user));
    }

Estou perdendo alguma coisa aqui? Como posso fazê-lo executar sem travar? Por favor sugira.

O acesso ao banco de dados no thread principal que bloqueia a IU é o erro, como disse Dale.

Crie uma classe aninhada estática (para evitar vazamento de memória) em sua Activity estendendo AsyncTask.

private static class AgentAsyncTask extends AsyncTask<Void, Void, Integer> {

    //Prevent leak
    private WeakReference<Activity> weakActivity;
    private String email;
    private String phone;
    private String license;

    public AgentAsyncTask(Activity activity, String email, String phone, String license) {
        weakActivity = new WeakReference<>(activity);
        this.email = email;
        this.phone = phone;
        this.license = license;
    }

    @Override
    protected Integer doInBackground(Void... params) {
        AgentDao agentDao = MyApp.DatabaseSetup.getDatabase().agentDao();
        return agentDao.agentsCount(email, phone, license);
    }

    @Override
    protected void onPostExecute(Integer agentsCount) {
        Activity activity = weakActivity.get();
        if(activity == null) {
            return;
        }

        if (agentsCount > 0) {
            //2: If it already exists then prompt user
            Toast.makeText(activity, "Agent already exists!", Toast.LENGTH_LONG).show();
        } else {
            Toast.makeText(activity, "Agent does not exist! Hurray :)", Toast.LENGTH_LONG).show();
            activity.onBackPressed();
        }
    }
}

Ou você pode criar uma classe final em seu próprio arquivo.

Em seguida, execute-o no método signUpAction (View view):

new AgentAsyncTask(this, email, phone, license).execute();

Em alguns casos, você também pode desejar manter uma referência à AgentAsyncTask em sua atividade para que possa cancelá-la quando a Activity for destruída. Mas você mesmo teria que interromper qualquer transação.

Além disso, sua pergunta sobre o exemplo de teste do Google ... Eles afirmam nessa página da web:

A abordagem recomendada para testar sua implementação de banco de dados é escrever um teste JUnit que é executado em um dispositivo Android. Como esses testes não exigem a criação de uma atividade, eles devem ser mais rápidos de executar do que os testes de IU.

Sem atividade, sem IU.

--EDITAR--

Para quem está se perguntando ... Você tem outras opções. Recomendo dar uma olhada nos novos componentes ViewModel e LiveData. O LiveData funciona muito bem com o Room. https://developer.android.com/topic/libraries/architecture/livedata.html

Outra opção é o RxJava / RxAndroid. Mais poderoso, mas mais complexo do que LiveData. https://github.com/ReactiveX/RxJava

--EDIT 2--

Já que muitas pessoas podem se deparar com essa resposta ... A melhor opção hoje em dia, de modo geral, são os Kotlin Coroutines. A Room agora oferece suporte direto (atualmente em beta). https://kotlinlang.org/docs/reference/coroutines-overview.html https://developer.android.com/jetpack/androidx/releases/room#2.1.0-beta01

Não é recomendado, mas você pode acessar o banco de dados no thread principal com allowMainThreadQueries()

MyApp.database =  Room.databaseBuilder(this, AppDatabase::class.java, "MyDatabase").allowMainThreadQueries().build()

Corrotinas Kotlin (claras e concisas)

AsyncTask é realmente desajeitado. Corrotinas são uma alternativa mais limpa (apenas polvilhe algumas palavras-chave e seu código de sincronização se torna assíncrono).

// Step 1: add `suspend` to your fun
suspend fun roomFun(...): Int
suspend fun notRoomFun(...) = withContext(Dispatchers.IO) { ... }

// Step 2: launch from coroutine scope
private fun myFun() {
    lifecycleScope.launch { // coroutine on Main
        val queryResult = roomFun(...) // coroutine on IO
        doStuff() // ...back on Main
    }
}

Dependências (adiciona escopos de co-rotina para componentes de arco):

// lifecycleScope:
implementation 'androidx.lifecycle:lifecycle-runtime-ktx:2.2.0-alpha04'

// viewModelScope:
implementation 'androidx.lifecycle:lifecycle-viewmodel-ktx:2.2.0-alpha04'

- Atualizações:
08 de maio de 2019: Room 2.1 agora oferece suporte a suspend
13 de setembro de 2019: Atualizado para usar o escopo de componentes de arquitetura

Para todos os amantes de RxJava ou RxAndroid ou RxKotlin lá fora

Observable.just(db)
          .subscribeOn(Schedulers.io())
          .subscribe { db -> // database operation }

Você não pode executá-lo no thread principal em vez de usar manipuladores, threads assíncronos ou de trabalho. Um código de amostra está disponível aqui e leia o artigo sobre a biblioteca de salas aqui: Biblioteca de salas do Android

/**
 *  Insert and get data using Database Async way
 */
AsyncTask.execute(new Runnable() {
    @Override
    public void run() {
        // Insert Data
        AppDatabase.getInstance(context).userDao().insert(new User(1,"James","Mathew"));

        // Get Data
        AppDatabase.getInstance(context).userDao().getAllUsers();
    }
});

Se você deseja executá-lo no thread principal, que não é o caminho preferido.

Você pode usar este método para obter no tópico principal Room.inMemoryDatabaseBuilder()

Com lambda é fácil de executar com AsyncTask

 AsyncTask.execute(() -> //run your query here );

Com a biblioteca Jetbrains Anko, você pode usar o método doAsync {..} para executar chamadas de banco de dados automaticamente. Isso resolve o problema de verbosidade que você parecia estar tendo com a resposta de mcastro.

Exemplo de uso:

    doAsync { 
        Application.database.myDAO().insertUser(user) 
    }

Eu uso isso com freqüência para inserções e atualizações, no entanto, para consultas selecionadas, recomendo usando o fluxo de trabalho RX.

Basta fazer as operações do banco de dados em um Thread separado. Assim (Kotlin):

Thread {
   //Do your database´s operations here
}.start()

Você deve executar a solicitação em segundo plano. Uma maneira simples poderia ser usando um Executores :

Executors.newSingleThreadExecutor().execute { 
   yourDb.yourDao.yourRequest() //Replace this by your request
}

Uma solução RxJava / Kotlin elegante deve ser usada Completable.fromCallable, que lhe dará um Observable que não retorna um valor, mas pode ser observado e inscrito em um thread diferente.

public Completable insert(Event event) {
    return Completable.fromCallable(new Callable<Void>() {
        @Override
        public Void call() throws Exception {
            return database.eventDao().insert(event)
        }
    }
}

Ou em Kotlin:

fun insert(event: Event) : Completable = Completable.fromCallable {
    database.eventDao().insert(event)
}

Você pode observar e se inscrever como faria normalmente:

dataManager.insert(event)
    .subscribeOn(scheduler)
    .observeOn(AndroidSchedulers.mainThread())
    .subscribe(...)

Você pode permitir o acesso ao banco de dados no thread principal, mas apenas para fins de depuração, você não deve fazer isso na produção.

Aqui está o motivo.

Observação: o Room não oferece suporte para acesso ao banco de dados no thread principal, a menos que você tenha chamado allowMainThreadQueries () no construtor, pois isso pode bloquear a IU por um longo período de tempo. As consultas assíncronas - consultas que retornam instâncias de LiveData ou Flowable - estão isentas dessa regra porque executam a consulta de forma assíncrona em um thread de segundo plano quando necessário.

Simplesmente você pode usar este código para resolvê-lo:

Executors.newSingleThreadExecutor().execute(new Runnable() {
                    @Override
                    public void run() {
                        appDb.daoAccess().someJobes();//replace with your code
                    }
                });

Ou em lambda você pode usar este código:

Executors.newSingleThreadExecutor().execute(() -> appDb.daoAccess().someJobes());

Você pode substituir appDb.daoAccess().someJobes()por seu próprio código;

Como asyncTask está obsoleto, podemos usar o serviço do executor. OU você também pode usar ViewModel com LiveData conforme explicado em outras respostas.

Para usar o serviço do executor, você pode usar algo como abaixo.

public class DbHelper {

    private final Executor executor = Executors.newSingleThreadExecutor();

    public void fetchData(DataFetchListener dataListener){
        executor.execute(() -> {
                Object object = retrieveAgent(agentId);
                new Handler(Looper.getMainLooper()).post(() -> {
                        dataListener.onFetchDataSuccess(object);
                });
        });
    }
}

O Looper principal é usado para que você possa acessar o elemento da IU a partir do onFetchDataSuccessretorno de chamada.

A mensagem de erro,

Não é possível acessar o banco de dados no thread principal, pois pode bloquear potencialmente a IU por longos períodos de tempo.

É bastante descritivo e preciso. A questão é como você deve evitar acessar o banco de dados no thread principal. Esse é um tópico enorme, mas para começar, leia sobre AsyncTask (clique aqui)

-----EDITAR----------

Vejo que você está tendo problemas ao executar um teste de unidade. Você tem algumas opções para corrigir isso:

1. Execute o teste diretamente na máquina de desenvolvimento em vez de em um dispositivo Android (ou emulador). Isso funciona para testes que são centrados em banco de dados e não se importam se estão sendo executados em um dispositivo.

2. Use a anotação @RunWith(AndroidJUnit4.class) para executar o teste no dispositivo Android, mas não em uma atividade com IU. Mais detalhes sobre isso podem ser encontrados neste tutorial

Se você se sentir mais confortável com a tarefa Async :

  new AsyncTask<Void, Void, Integer>() {
                @Override
                protected Integer doInBackground(Void... voids) {
                    return Room.databaseBuilder(getApplicationContext(),
                            AppDatabase.class, DATABASE_NAME)
                            .fallbackToDestructiveMigration()
                            .build()
                            .getRecordingDAO()
                            .getAll()
                            .size();
                }

                @Override
                protected void onPostExecute(Integer integer) {
                    super.onPostExecute(integer);
                    Toast.makeText(HomeActivity.this, "Found " + integer, Toast.LENGTH_LONG).show();
                }
            }.execute();

Atualização: também recebi esta mensagem quando estava tentando construir uma consulta usando @RawQuery e SupportSQLiteQuery dentro do DAO.

@Transaction
public LiveData<List<MyEntity>> getList(MySettings mySettings) {
    //return getMyList(); -->this is ok

    return getMyList(new SimpleSQLiteQuery("select * from mytable")); --> this is an error

Solução: construa a consulta dentro do ViewModel e passe para o DAO.

public MyViewModel(Application application) {
...
        list = Transformations.switchMap(searchParams, params -> {

            StringBuilder sql;
            sql = new StringBuilder("select  ... ");

            return appDatabase.rawDao().getList(new SimpleSQLiteQuery(sql.toString()));

        });
    }

Ou...

Você não deve acessar o banco de dados diretamente no thread principal, por exemplo:

 public void add(MyEntity item) {
     appDatabase.myDao().add(item); 
 }

Você deve usar AsyncTask para atualizar, adicionar e excluir operações.

Exemplo:

public class MyViewModel extends AndroidViewModel {

    private LiveData<List<MyEntity>> list;

    private AppDatabase appDatabase;

    public MyViewModel(Application application) {
        super(application);

        appDatabase = AppDatabase.getDatabase(this.getApplication());
        list = appDatabase.myDao().getItems();
    }

    public LiveData<List<MyEntity>> getItems() {
        return list;
    }

    public void delete(Obj item) {
        new deleteAsyncTask(appDatabase).execute(item);
    }

    private static class deleteAsyncTask extends AsyncTask<MyEntity, Void, Void> {

        private AppDatabase db;

        deleteAsyncTask(AppDatabase appDatabase) {
            db = appDatabase;
        }

        @Override
        protected Void doInBackground(final MyEntity... params) {
            db.myDao().delete((params[0]));
            return null;
        }
    }

    public void add(final MyEntity item) {
        new addAsyncTask(appDatabase).execute(item);
    }

    private static class addAsyncTask extends AsyncTask<MyEntity, Void, Void> {

        private AppDatabase db;

        addAsyncTask(AppDatabase appDatabase) {
            db = appDatabase;
        }

        @Override
        protected Void doInBackground(final MyEntity... params) {
            db.myDao().add((params[0]));
            return null;
        }

    }
}

Se você usa LiveData para selecionar operações, não precisa de AsyncTask.

Para consultas rápidas, você pode permitir espaço para executá-lo no thread de interface do usuário.

AppDatabase db = Room.databaseBuilder(context.getApplicationContext(),
        AppDatabase.class, DATABASE_NAME).allowMainThreadQueries().build();

No meu caso tive que descobrir se o usuário clicado na lista existe no banco de dados ou não. Caso contrário, crie o usuário e inicie outra atividade

       @Override
        public void onClick(View view) {



            int position = getAdapterPosition();

            User user = new User();
            String name = getName(position);
            user.setName(name);

            AppDatabase appDatabase = DatabaseCreator.getInstance(mContext).getDatabase();
            UserDao userDao = appDatabase.getUserDao();
            ArrayList<User> users = new ArrayList<User>();
            users.add(user);
            List<Long> ids = userDao.insertAll(users);

            Long id = ids.get(0);
            if(id == -1)
            {
                user = userDao.getUser(name);
                user.setId(user.getId());
            }
            else
            {
                user.setId(id);
            }

            Intent intent = new Intent(mContext, ChatActivity.class);
            intent.putExtra(ChatActivity.EXTRAS_USER, Parcels.wrap(user));
            mContext.startActivity(intent);
        }
    }

Você pode usar Future e Callable. Portanto, você não seria obrigado a escrever uma longa asynctask e pode realizar suas consultas sem adicionar allowMainThreadQueries ().

Minha consulta dao: -

@Query("SELECT * from user_data_table where SNO = 1")
UserData getDefaultData();

Meu método de repositório: -

public UserData getDefaultData() throws ExecutionException, InterruptedException {

    Callable<UserData> callable = new Callable<UserData>() {
        @Override
        public UserData call() throws Exception {
            return userDao.getDefaultData();
        }
    };

    Future<UserData> future = Executors.newSingleThreadExecutor().submit(callable);

    return future.get();
}

Na minha opinião, a coisa certa a fazer é delegar a consulta a um thread de IO usando RxJava.

Tenho um exemplo de solução para um problema equivalente que acabei de encontrar.

((ProgressBar) view.findViewById(R.id.progressBar_home)).setVisibility(View.VISIBLE);//Always good to set some good feedback
        Completable.fromAction(() -> {
            //Creating view model requires DB access
            homeViewModel = new ViewModelProvider(this, factory).get(HomeViewModel.class);
        }).subscribeOn(Schedulers.io())//The DB access executes on a non-main-thread thread
        .observeOn(AndroidSchedulers.mainThread())//Upon completion of the DB-involved execution, the continuation runs on the main thread
        .subscribe(
                () ->
                {
                    mAdapter = new MyAdapter(homeViewModel.getExams());
                    recyclerView.setAdapter(mAdapter);
                    ((ProgressBar) view.findViewById(R.id.progressBar_home)).setVisibility(View.INVISIBLE);
                },
                error -> error.printStackTrace()
        );

E se quisermos generalizar a solução:

((ProgressBar) view.findViewById(R.id.progressBar_home)).setVisibility(View.VISIBLE);//Always good to set some good feedback
        Completable.fromAction(() -> {
            someTaskThatTakesTooMuchTime();
        }).subscribeOn(Schedulers.io())//The long task executes on a non-main-thread thread
        .observeOn(AndroidSchedulers.mainThread())//Upon completion of the DB-involved execution, the continuation runs on the main thread
        .subscribe(
                () ->
                {
                    taskIWantToDoOnTheMainThreadWhenTheLongTaskIsDone();
                },
                error -> error.printStackTrace()
        );