基于springboot的美食点评APP设计与实现

男娘i 2024-04-06 12:54 70阅读 0赞

1.  引言 2  
    1.1编写目的 2  
    1.2项目背景 2  
    1.3定义 3
2.  总体设计 3  
    2.1用例图 3  
    2.2需求规定 4  
    2.3全局变量 4  
    2.4运行环境 4  
    2.5开发工具 5
3.  UI设计 5  
    3.1菜品推荐界面 5  
    3.1.1界面简介 5  
    3.1.2界面展示 5  
    3.2菜品分类搜索 5  
    3.2.1界面简介 5  
    3.2.2界面展示 5  
    3.2菜品详细信息展示界面 6  
    3.2.1界面简介 6  
    3.2.2界面展示 6  
    3.3菜品评价界面 7  
    3.3.1界面简介 7  
    3.3.2界面展示 7  
    3.4登录注册界面 7  
    3.4.1界面简介 7  
    3.4.2界面展示 7  
    3.5用户中心界面 8  
    3.5.1界面简介 8  
    3.5.2界面展示 8
4.  接口设计 9  
    4.1接口列表 9  
    4.2接口说明 13
5.  项目总结 17  
    1.引言  
    为适应市场需求，满足顾客方便快捷的搜索到优秀餐饮，快速浏览菜品相关详细信息，本项目计划开发大众美食点评APP，该APP将会满足顾客的食品搜索，食品点评，店家搜索等需求。  
    1.1编写目的  
    本节描述软件详细设计文档的目的是：  
    定义软件总体要求，作为用户和软件开发人员之间互相了解的基础；  
    作为软件总体测试和系统结构设计的依据；  
    本文档的预期读者包括：软件设计人员、模块开发人员、管理人员、测试人员。  
    1.2项目背景  
    项目名称:FoodFans；  
    项目提出者:XXX；  
    开发者:XXX，XXX，XXX；  
    1.3定义  
    MYSQL：一种免费的功能较强的数据库管理系统  
    Android Studio：本文转载自http://www.biyezuopin.vip/onews.asp?id=14920基于IntelliJ IDEA. 类似Eclipse ADT，Android Studio 提供了集成的 Android 开发工具用于开发和调试。  
    1.4技术路线：retrofit+room+recyclerview+gridview+listview+livedata  
    后端：springboot+mybatis+jwt(token验证）  
    3.功能设计  
    用户:  
    注册、登录、找回密码、更改密码、修改个人信息  
    浏览推荐菜谱文章(可含视频)或是通过分类后浏览菜谱文章(可含视频)，  
    对菜谱进行评论评分、点赞、收藏、分享和打赏  
    发表相应菜谱文章(可含视频)  
    搜素菜谱文章(可含视频)  
    利用自己打赏的积分进行礼品兑换  
    管理自己上传的菜谱文章（作品）  
    查看自己的最近的浏览历史记录  
    可以关注其他人  
    关注之后可以发送留言消息  
    查看自己的关注列表  
    用户可以查看留言列表  
    用户可以查看关注自己的粉丝列表

积分制度:  
用途: 用来兑换系统提供的各种精美礼品  
获得方式: 发表菜谱文章，积分充值，当某篇菜谱点赞数达到一定数量会为作者添加积分，当作者被人关注后也会添加积分。

package com.star.foodfans.ui.view;
    
    import android.content.Context;
    import android.content.res.TypedArray;
    import android.graphics.Color;
    import android.util.AttributeSet;
    import android.util.DisplayMetrics;
    import android.util.TypedValue;
    import android.view.Gravity;
    import android.view.View;
    import android.view.ViewGroup;
    import android.view.WindowManager;
    import android.widget.HorizontalScrollView;
    import android.widget.LinearLayout;
    import android.widget.RelativeLayout;
    import android.widget.TextView;
    
    
    import androidx.viewpager.widget.ViewPager;
    
    import com.star.foodfans.R;
    
    import java.util.List;
    
    
    /**
     * ViewPagerIndicator
     * Created by HaPBoy on 5/10/16.
     */
    public class ViewPagerIndicator extends HorizontalScrollView {
        
    
        private Context mContext;
    
        private List<String> mTitles; // 接收传递过来的title
        private ViewPager mViewPager; // 接收关联的ViewPager
    
        private LinearLayout llTabRoot; // Tab布局
        private RelativeLayout rlRoot; // 根布局
        private View vLine; // 横线
        private RelativeLayout.LayoutParams lineLayoutParams;
    
        private int mTabVisibleCount; // 可见tab的数量
        private int mSizeText; // tab标签文字大小(sp)
        private int mColorTextNormal; // 正常字体颜色
        private int mColorTextHighlight; // 高亮字体颜色
        private int mColorLine; // 横线颜色
        private int mHeightLine; // 线高(dp)
    
        private static final int COUNT_DEFAULT_TAB = 4; // 默认可见tab为4个
        private static final int SIZE_TEXT = 16; // 默认tab标签文字大小(sp)
        private static final int COLOR_TEXT_NORMAL = Color.parseColor("#000000"); // 默认正常字体颜色
        private static final int COLOR_TEXT_HIGHLIGHT = Color.parseColor("#FFFFFF"); // 默认高亮字体颜色
        private static final int COLOR_LINE = Color.parseColor("#000000"); // 默认横线颜色
        private static final int HEIGHT_LINE = 2; // 默认线高(dp)
    
        public ViewPagerIndicator(Context context) {
        
            super(context, null);
        }
    
        public ViewPagerIndicator(Context context, AttributeSet attrs) {
        
            super(context, attrs);
            mContext = context;
    
            // 获取XML中的配置属性
            TypedArray attributes = context.obtainStyledAttributes(attrs, R.styleable.ViewPagerIndicator);
            mTabVisibleCount = attributes.getInt(R.styleable.ViewPagerIndicator_tab_visible_count, COUNT_DEFAULT_TAB);
            if (mTabVisibleCount < 0) {
        
                mTabVisibleCount = COUNT_DEFAULT_TAB;
            }
            mSizeText = attributes.getInt(R.styleable.ViewPagerIndicator_tab_text_size, SIZE_TEXT);
            mColorTextNormal = attributes.getInt(R.styleable.ViewPagerIndicator_tab_text_normal_color, COLOR_TEXT_NORMAL);
            mColorTextHighlight = attributes.getInt(R.styleable.ViewPagerIndicator_tab_text_highlight_color, COLOR_TEXT_HIGHLIGHT);
            mColorLine = attributes.getInt(R.styleable.ViewPagerIndicator_tab_line_color, COLOR_LINE);
            mHeightLine = attributes.getInt(R.styleable.ViewPagerIndicator_tab_line_height, HEIGHT_LINE);
            attributes.recycle();
    
            initViews();
        }
    
        private void initViews() {
        
            setHorizontalScrollBarEnabled(false);
    
            // 根布局
            rlRoot = new RelativeLayout(mContext);
            rlRoot.setLayoutParams(new ViewGroup.LayoutParams(LayoutParams.MATCH_PARENT, LayoutParams.MATCH_PARENT));
            this.addView(rlRoot);
    
            // Tab布局
            llTabRoot = new LinearLayout(mContext);
            llTabRoot.setOrientation(LinearLayout.HORIZONTAL);
            llTabRoot.setLayoutParams(new ViewGroup.LayoutParams(LayoutParams.MATCH_PARENT, LayoutParams.MATCH_PARENT));
            rlRoot.addView(llTabRoot);
    
            // 横线
            vLine = new View(mContext);
            lineLayoutParams = new RelativeLayout.LayoutParams(getScreenWidth() / mTabVisibleCount, DpToPx(mHeightLine));
            lineLayoutParams.addRule(RelativeLayout.ALIGN_PARENT_BOTTOM);
            vLine.setLayoutParams(lineLayoutParams);
            vLine.setBackgroundColor(mColorLine);
            rlRoot.addView(vLine);
        }
    
        /**
         * xml加载完成之后，回调此方法
         * 设置每个tab的LayoutParams
         */
        @Override
        protected void onFinishInflate() {
        
            super.onFinishInflate();
            int childCount = llTabRoot.getChildCount();
            if (childCount == 0) {
        
                return;
            }
    
            for (int i = 0; i < childCount; i++) {
        
                View view = llTabRoot.getChildAt(i);
                LinearLayout.LayoutParams params = (LinearLayout.LayoutParams) view.getLayoutParams();
                params.width = getScreenWidth() / mTabVisibleCount;
                view.setLayoutParams(params);
            }
    
            // 横线长度
            lineLayoutParams.width = getScreenWidth() / mTabVisibleCount;
            vLine.setLayoutParams(lineLayoutParams);
        }
    
        /**
         * 动态设置tab的数量
         *
         * @param count
         */
        public void setVisibleTabCount(int count) {
        
            mTabVisibleCount = count;
            onFinishInflate();
        }
    
        /**
         * 动态设置tab
         *
         * @param titles
         */
        public void setTabItemTitles(List<String> titles) {
        
            if (titles != null && titles.size() > 0) {
        
                llTabRoot.removeAllViews();
                mTitles = titles;
                for (String title : mTitles) {
        
                    llTabRoot.addView(generateTextView(title));
                }
                setItemClickEvent();
            }
        }
    
        /**
         * 根据title创建tab
         *
         * @param title
         * @return view
         */
        private View generateTextView(String title) {
        
            LinearLayout.LayoutParams params = new LinearLayout.LayoutParams(getScreenWidth() / mTabVisibleCount, LayoutParams.MATCH_PARENT);
    
            TextView textView = new TextView(getContext());
            textView.setText(title);
            textView.setGravity(Gravity.CENTER);
            textView.setTextSize(TypedValue.COMPLEX_UNIT_SP, mSizeText);
            textView.setTextColor(mColorTextNormal);
            textView.setLayoutParams(params);
            return textView;
        }
    
    
        /**
         * 跟随ViewPager移动
         *
         * @param position
         * @param positionOffset
         */
        public void scroll(int position, float positionOffset) {
        
            int tabWidth = getWidth() / mTabVisibleCount;
            // 当Tab处于移动至最后一个时
            // position + 1 - (mTabVisibleCount - 1) + positionOffset
            if (position >= (mTabVisibleCount - 2) && positionOffset > 0 && llTabRoot.getChildCount() > mTabVisibleCount) {
        
                if (mTabVisibleCount != 1) {
        
                    scrollTo((int) ((position - (mTabVisibleCount - 2) + positionOffset) * tabWidth), 0);
                } else {
        
                    scrollTo((int) ((position + positionOffset) * tabWidth), 0);
                }
            }
    
            // 移动横线
            lineLayoutParams.leftMargin = (int) ((position + positionOffset) * tabWidth);
            vLine.setLayoutParams(lineLayoutParams);
        }
    
        /**
         * 设置关联的ViewPager
         *
         * @param viewpager
         * @param position
         */
        public void setViewPager(ViewPager viewpager, int position) {
        
            mViewPager = viewpager;
            mViewPager.setOnPageChangeListener(new ViewPager.OnPageChangeListener() {
        
    
                @Override
                public void onPageSelected(int position) {
        
                    highLightTextView(position);
                }
    
                @Override
                public void onPageScrolled(int position, float positionOffset, int positionOffsetPixels) {
        
                    // 滑动Tab和横线
                    scroll(position, positionOffset);
                }
    
                @Override
                public void onPageScrollStateChanged(int state) {
        
    
                }
            });
            mViewPager.setCurrentItem(position);
            highLightTextView(position);
        }
    
        /**
         * 高亮被点击的tab
         *
         * @param position
         */
        private void highLightTextView(int position) {
        
            resetTextViewColor();
            View view = llTabRoot.getChildAt(position);
            if (view instanceof TextView) {
        
                ((TextView) view).setTextColor(mColorTextHighlight);
            }
        }
    
        /**
         * 重置tab文本颜色
         */
        private void resetTextViewColor() {
        
            for (int i = 0; i < llTabRoot.getChildCount(); i++) {
        
                View view = llTabRoot.getChildAt(i);
                if (view instanceof TextView) {
        
                    ((TextView) view).setTextColor(mColorTextNormal);
                }
            }
        }
    
        /**
         * 设置Tab的点击事件
         */
        private void setItemClickEvent() {
        
            int childCount = llTabRoot.getChildCount();
            for (int i = 0; i < childCount; i++) {
        
                final int j = i;
                View view = llTabRoot.getChildAt(i);
                view.setOnClickListener(new OnClickListener() {
        
                    @Override
                    public void onClick(View v) {
        
                        mViewPager.setCurrentItem(j);
                    }
                });
            }
        }
    
        /**
         * 获取屏幕的宽度
         *
         * @return screenWidth
         */
        private int getScreenWidth() {
        
            WindowManager wm = (WindowManager) getContext().getSystemService(Context.WINDOW_SERVICE);
            DisplayMetrics outMetrics = new DisplayMetrics();
            wm.getDefaultDisplay().getMetrics(outMetrics);
            return outMetrics.widthPixels;
        }
    
        /**
         * 将DP转换为PX
         *
         * @param dp 要转换的像素无关单位
         * @return int
         */
        private int DpToPx(double dp) {
        
            float scale = getResources().getDisplayMetrics().density;
            return (int) (dp * scale + 0.5f);
        }
    }

![在这里插入图片描述][47335c4691904d9c89d8ec6674d408ae.png_pic_center]  
![在这里插入图片描述][09cb9b1abd1e4cb7bfe50a54c6b438b9.png_pic_center]  
![在这里插入图片描述][d42d2a7a685b4862bf0c9819f9dafd0f.png_pic_center]  
![在这里插入图片描述][4aba6a54a8b9443ca0decff74561557b.png_pic_center]  
![在这里插入图片描述][4d8a1a72f77f488983b0b215928f6bc1.png_pic_center]  
![在这里插入图片描述][eb4cae76635a46cc93622fc927f5f19b.png_pic_center]  
![在这里插入图片描述][5aa52bea8f5440ea92b8f8fb32681308.png_pic_center]  
![在这里插入图片描述][9ef177f74e2a496d8b43317581c2bcc9.png_pic_center]  
![在这里插入图片描述][f99ec9e29e634b0a9d1ff708cecdafd7.png_pic_center]  
![在这里插入图片描述][26cd631c32b941039310be046d04921b.png_pic_center]  
![在这里插入图片描述][42195db26d214555b88feecfb027aa6f.png_pic_center]  
![在这里插入图片描述][32504a558a26474699cf74d07e070506.png_pic_center]  
![在这里插入图片描述][6c0671ccef40435fb3db6ff01c9e8296.png_pic_center]  
![在这里插入图片描述][d4571b7fe6fa483e8b848f89b0b9e3f3.png_pic_center]  
![在这里插入图片描述][d384cd9ff0674c01833907ca383ad003.png_pic_center]

[47335c4691904d9c89d8ec6674d408ae.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/06/e33e4d74af1641adae7c9fa459ca220e.png
[09cb9b1abd1e4cb7bfe50a54c6b438b9.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/06/8d54abbc70d4415a9f3fc5e005f03b13.png
[d42d2a7a685b4862bf0c9819f9dafd0f.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/06/71e92fecf37d4741a08275e15bc6be8c.png
[4aba6a54a8b9443ca0decff74561557b.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/06/324593c2cebb4697b06b1189a0fcdcea.png
[4d8a1a72f77f488983b0b215928f6bc1.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/06/6de79ce8929045bba8ca88cf92eae981.png
[eb4cae76635a46cc93622fc927f5f19b.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/06/51bdcd6ebeab49f892bae3506d9e475b.png
[5aa52bea8f5440ea92b8f8fb32681308.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/06/61f343e7a30a463690e29283e8f76227.png
[9ef177f74e2a496d8b43317581c2bcc9.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/06/a1f4759619204885b8d022efc2f261cc.png
[f99ec9e29e634b0a9d1ff708cecdafd7.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/06/fc0e189fdfdd4f23aa32a9a044b2cc28.png
[26cd631c32b941039310be046d04921b.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/06/2e6585aa3cf24fdeb0ff6573d8e05d5e.png
[42195db26d214555b88feecfb027aa6f.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/06/03dd7a25f3784ca68ba8faa2e40cfeda.png
[32504a558a26474699cf74d07e070506.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/06/d00ea342d3084198b1c7cd057127c5d2.png
[6c0671ccef40435fb3db6ff01c9e8296.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/06/3175c5e8dfd4433b936de407d6291d56.png
[d4571b7fe6fa483e8b848f89b0b9e3f3.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/06/5d9e1cafc1854fcb9fb33f99238ab653.png
[d384cd9ff0674c01833907ca383ad003.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/06/326f7b353e8344509dbbe33297c7426b.png