Announcement: Due to insufficient funds of the author and unable to provide corresponding services for this program, the author has decided (short-term) not to provide services for this program. The author will stop sending verification codes and registration services on July 13, 2021, and stop the service of the program on July 18, 2021. You will no longer be able to register, log in, chat, etc.

MSChatRoom (MSCR)

An Android chat application using MINA framework (communication) and MySQL database (account information storage)
If you want to use the old version of this application, you need to download the source code of the target version, unzip it, and check its README file.
Starting from version v1.3, you can directly download the installation package and install and use, you don't need to build your own server as before. If you need, you can go to Preparation for self compiling and running.

点我转到中文的README页面
Click me to go to the update log of this application

Copyright

MrShiehX own this application's copyright.
Anyone can take advices of this application to us.

Version

The latest version:
1.3.1 (May 12, 2021) (Corresponding to server 1.3)
Historical version:
1.3.1 (May 12, 2021) (Corresponding to server 1.3)
1.3 (May 10, 2021) (Corresponding to server 1.3)
1.2.1 (Apr. 15, 2021) (Corresponding to server 1.2)
1.2 (Apr. 14, 2021) (Corresponding to server 1.2)
1.1.1 (Apr. 7, 2021) (Corresponding to server 1.1)
1.1 (Apr. 5, 2021) (Corresponding to server 1.1)
1.0 (Jan. 31, 2021) (Corresponding to server 1.0)
beta-2 (Jan. 26, 2021)
beta-1 (Jan. 21, 2021)
alpha-6 (Dec. 27, 2020)
alpha-5 (Dec. 26, 2020)
alpha-4 (Dec. 20, 2020)
alpha-3 (Dec. 17, 2020)
alpha-2 (Dec. 7, 2020)
alpha-1 (Dec. 5, 2020)

The software configuration required for this application is:

• Android 4.0 and above

Supported languages

You can set the language in the settings.

• English (United States)
• Simplified Chinese (China)

Found BUGs

• If the app is not running in the background or in the foreground, there will be no new message notification reminders.
• If the app opens the Chat interface or the Main interface and then leaves the app (not exiting), you will not receive new messages notification.
• Lower versions of Android may not be able to notify after receiving the message.
• (Fixed in alpha-6) Users can add chats without login.
• (Fixed in beta-1) When adding a chat, if the current number of chats >= 2, it will replace the last one, but it has been added successfully. Restart the application to see the newly added chat.
• (Fixed in beta-1) The application may crash after modifying the user information for unknown reasons.
• (Fixed in alpha-3) After you login, open the settings, the user information (avatar, name and what's up) may not be displayed. This problem will be fixed in the future.

Precautions

• In order to avoid problems in the program, please do not bypass the Loading interface (StartActivity) and directly enter the application by other means.

Text encryption and decryption

Use the encryption or decryption algorithm of the src/java/com/mrshiehx/mschatroom/utils/EnDeCryptTextUtils.java class

Working Principle

Register

After encrypting the email address or account and password, use the insert command to create new data in the MySQL database.

Login

After encrypting the email address or account and password, use the select command to check whether the data exists in the MySQL database. If it exists, store the login data in SharedPreference.

Reset password

After encrypting the email address and password, check whether the account exists. If it exists, use the update command to modify the password data.

Login with email address

After encrypting the email address, use the select command in the MySQL database to check whether the data exists. If it does, the password is obtained and the login data is stored in SharedPreference.

Log out

Delete the email address or account and password data in SharedPreference.

Delete account

After encrypting the email address or account and password, use the delete command to delete the data in the MySQL database and log out.

Modify avatar

After encrypting the email address or account and password, select the file to be set as the avatar, and then use the update command to update the InputStream.

Modify nickname, gender or what's up

After encrypting the email address or account and password, download the InputStream in the information from the database, modify its content, and then use the update command to update the InputStream.

Clear cache

Delete all files in the /data/data/com.mrshiehx.mschatroom/cache directory.

Clear application data

Delete all files in the /data/data/com.mrshiehx.mschatroom directory.

Preparation for self compiling and running

First of all, you need to have a server (if you don’t have one, you can use your local computer), and the MySQL database needs to be installed on this server. After you are ready, you need to create a new database in MySQL. "mscr" is the database name, you can change it.

create database mscr;

Then we enter the database.

use mscr;

After entering, create a new table in the following format

You can enter the following command to create a new table, where "users" is the name of the table.

create table `users` (`email` varchar(1000) not null,`account` varchar(1000) not null,`password` varchar(1000) not null,`information` mediumblob not null,`avatar` mediumblob,`messages` text(4294967295));

At this point, if everything goes well without errors, then you can proceed to the next step.

After setting up a server with MySQL, modify the variable content in the file Variables.java in the src/java/com/mrshiehx/mschatroom directory (representatives not listed in the table below do not need to be modified)

Variable name	Meaning
SERVER_ADDRESS	Default server (or local computer) address (database)
SERVER_ADDRESS_COMMUNICATION	Default server (or local computer) address (communication)
SERVER_PORT	Default server (or local computer) port (used for communication)
DATABASE_NAME	Default MySQL database name
DATABASE_USER_NAME	Default MySQL database account
DATABASE_USER_PASSWORD	Default MySQL database password
DATABASE_TABLE_NAME	Default MySQL table name
TEXT_ENCRYPTION_KEY	Text encryption key (not too long or too short)
CAPTCHA_EMAIL_SMTP_SERVER_ADDRESS	The SMTP server address of the mailbox that sends the CAPTCHA email (see below)
CAPTCHA_EMAIL_ADDRESS	The email address for sending the CAPTCHA email (see below)
AUTHENTICATOR	Authorization code of the mailbox sending the verification code email (see below)

Regarding the e-mail address for sending the CAPTCHA, please create an email yourself, and then enable the IMAP/SMTP service and POP3/SMTP service of the email, and write down the email address, authorization code and SMTP address of the email service , Input in Variables.java. You can also choose to modify the method content in the SendEmailUtils.java file in the src/java/com/mrshiehx/mschatroom/utils directory

The number of rows	Method name	Meaning
38	setSubject	CAPTCHA email title
42	setContent	CAPTCHA email content

For the application to use the chat communication function normally, you need to go to the repository of MSChatRoom Server and read its README file carefully.

After all these tasks are completed, you can compile the application and run it.

About Author

MrShiehX

• Occupation:
  Student
  
• Email address:
  Bntoylort@outlook.com
  
• QQ:
  3553413882 (Remember to tell me why you want to add me)
  

If you find any bugs in this application or have new ideas, please send an email or add my QQ.