*سلیب* که از امنیت کوئرا به ستوه آمده بود، با *نیما* (اسطوره‌ی امنیت در سطح بین‌المللی) در این‌باره صحبتی را شروع کرد. *نیما* به این نتیجه رسید که کوئرا نیاز به یک اقدام امنیتی در ورود به حساب کاربری دارد. پیشنهاد او تأیید از طریق *SMS* بود و تأکید اکیدی بر زمان انقضای آن‌ها داشت. به نظر او هر کد تأیید باید فقط برای ۱۰ ثانیه معتبر می‌بودند و پس از گذشت بیش از ۱۰ ثانیه، کد دیگر مورد قبول نباشد. *سلیب* از آن‌سو تاکید بر ماندگاری دیتا‌ها داشت. به نظر او نیاز بود تا تمامی اطلاعات را به فرمت زیر در یک فایل *CSV* نگه‌داری کند: ```csv sample-data.csv csv Phone,Code,Expiration ``` در ستون اول شماره مورد نظر، ستون دوم کد ساخته شده برای شماره و در ستون سوم اعتبار کد را نمایش می‌دهد، در ادامه به بیان جزئیات بیشتر سؤال می‌پردازیم. # جزئیات پروژه پروژه‌ی اولیه را از [این لینک](/problemset/assignments/4367/download_problem_initial_project/169492/) دانلود کنید. ساختار فایل‌های پروژه به‌صورت زیر است: ``` SMSAuthentication ├── pom.xml ├── src │ ├── main │ │ └── java │ │ └── org │ │ └── quera │ │ └── smsauthentication │ │ └── <mark class="red" title="شما تنها مجاز به تغیر این فایل هستید.">SMSAuthentication.java</mark> │ └── test │ └── java │ └── org │ └── quera │ └── smsauthentication │ └── SMSAuthenticationSampleTest.java └── test.csv ``` شما باید متدهای `generateCode`، `sendAuthenticationSMS`، `loadData`، `verifyCode` موجود در کلاس `SMSAuthentication` را مطابق با خواسته‌های سؤال پیاده‌سازی کنید. نمای کلی فایل مورد نظر به شکل زیر است: ```java SMSAuthentication.java java package org.quera.smsauthentication; import ... public class SMSAuthentication { public static String generateCode() { // TODO: Implement } public static String sendAuthenticationSMS(String phone, String path) { // TODO: Implement } public static List<String[]> loadData(String path) { // TODO: Implement } public static boolean verifyCode(String code, String phone, String path) { // TODO: Implement } public static void main(String[] args) { System.out.println(sendAuthenticationSMS("09381358888", "test.csv")); Scanner sc = new Scanner(System.in); String code = sc.next(); System.out.println(verifyCode(code,"09381358888","test.csv")); } } ``` ## متد `generateCode` این متد باید یک رشته تصادفی به **طول ۵** بسازد و مقدار آن را برگرداند. در این رشته می‌توانید از **فقط متشکل از ارقام انگلیسی** استفاده کنید. نمونه‌ی اجرای متد در زیر آمده است: ```java Terminal terminal >>> generateCode() 40142 >>> generateCode() 18272 >>> generateCode() 00168 ``` ## متد `sendAuthenticationSMS` این متد یک رشته به عنوان شماره و رشته‌ای دیگر به عنوان آدرس فایلی که باید اطلاعات را در آن ذخیره کند، به عنوان ورودی دریافت می‌کند. خروجی این متد باید رشته‌ای به فرمت `JSON` باشد. در خروجی `JSON` مورد نظر باید کلید و مقدارهای زیر را داشته باشد: * کلید `phone` برابر با مقدار شماره مورد نظر خواهد بود. * کلید `code` برابر با کد ساخته شده برای شماره مورد نظر خواهد بود. * کلید `exp` برابر با زمانی که کد مورد نظر منقضی می‌شود است، زمان در این سؤال به فرمت `"yyyy/MM/dd-HH:mm:ss"` استفاده می‌شود. این متد باید این محتوا را درون فایل *CSV* موجود در آدرس `path` ذخیره کند. خروجی و رفتار خواسته شده در بخش مثال با جزئیات بیشتری نمایش داده شده است. ### مثال ```java Terminal terminal >>> sendAuthenticationSMS("09381354444", "test.csv") {"phone":"09381354444","code":"06505","exp":"2022/10/04-18:02:15"} >>> sendAuthenticationSMS("09381354443", "test.csv") {"phone":"09381354443","code":"26052","exp":"2022/10/04-18:07:39"} >>> sendAuthenticationSMS("09381354444", "test.csv") // duplicate {"phone":"09381354444","code":"00300","exp":"2022/10/04-19:02:48"} ``` محتوای چند خط آخر فایل `test.csv` پس از اجرای بالا برابر با زیر خواهد بود: ```csv test.csv csv Phone,Code,Expiration <mark class="red" title="محتواهای قبلی موجود در فایل">...</mark> 09381354444,06505,2022/10/04-18:02:15 09381354443,26052,2022/10/04-18:07:39 09381354444,00300,2022/10/04-19:02:48 ``` ## متد `loadData` این متد یک رشته به عنوان آدرس فایلی که باید اطلاعات آن را بخواند، به عنوان ورودی دریافت می‌کند. خروجی این متد لیستی از آرایه‌ای از `String`ها خواهد بود که برابر با مقادیر موجود در فایل *CSV* ورودی متد است. ### مثال برای مثال فرض کنید محتوای فایل *CSV* به‌صورت زیر باشد: ```csv test.csv csv Phone,Code,Expiration 09381354444,06505,2022/10/04-18:02:15 09381354443,26052,2022/10/04-18:07:39 09381354444,00300,2022/10/04-19:02:48 ``` اگر متد را به‌صورت زیر فراخوانی کنیم ```java snippet java List<String[]> allData = loadData("test.csv"); ``` و بخواهیم خروجی متد را به‌صورت زیر چاپ کنیم: ```java snippet java for(String[] data : allData) { for(String attr : data) { System.out.print(attr + " "); } System.out.println(); } ``` خروجی به‌صورت زیر خواهد بود ``` 09381354444 06505 2022/10/04-18:02:15 09381354443 26052 2022/10/04-18:07:39 09381354444 00300 2022/10/04-19:02:48 ``` **دقت کنید که خط اول** (یا همان `Phone,Code,Expiration`) **در خروجی متد وجود ندارد**. ## متد `verifyCode` این متد یک رشته به عنوان کد، یک رشته به عنوان شماره و رشته‌ای دیگر به عنوان آدرس فایلی که باید اطلاعات را از آن بخواند، به عنوان ورودی دریافت می‌کند. خروجی این متد یک `boolean` است که در صورتی که کد با شماره مورد نظر تطابق داشت و **کد منقضی نشده بود،** باید مقدار `true` برگرداند و در غیر این صورت مقدار `false` برگرداند. # نکات + شما در این سؤال مجاز به تغییر فایل `pom.xml` نیستید. + برای کار با `JSON`، تنها مجاز به استفاده از کتابخانه `opencsv` هستید. + برای کار با *CSV* ، تنها مجاز به استفاده از کتابخانه `jackson-databind` هستید. + به جز کتابخانه‌های موجود در `pom.xml`، تنها مجاز به استفاده از کتابخانه‌های استاندارد جاوا هستید. + هر کد تنها **ده ثانیه** زمان دارد. + **دقت کنید** که تاریخ و زمان انقضای کد را باید دقیقا برابر با ۱۰ ثانیه پس از تولید کد (یا فراخوانی متد `sendAuthenticationSMS`) قرار دهید. + شما مجاز به عوض کردن فرمت ذخیره‌سازی اطلاعات در فایل *CSV* نیستید و باید دقیقا برابر با فرمت خواسته شده، اطلاعات را ذخیره سازی کنید. + داوری این سؤال، بیشتر از باقی مسائل طول می‌کشد. # آن‌چه باید آپلود کنید پس از پیاده‌سازی موارد خواسته‌شده، فایل تمامی پروژه را زیپ کنید و آن را آپلود کنید. فایل زیپ شما باید به‌صورتی باشد که پس از خروج از حالت فشرده، پوشه‌ی `src` مشاهده شود.